Rust函数与FFI调用的C++函数执行顺序反转原因及文档查询

嘿，这个问题我之前帮人排查过，大概率是标准输出的缓冲机制在搞鬼！咱们来理清楚：

你看，Rust的println!宏默认是行缓冲，而且每次调用都会自动刷新输出缓冲区；但C/C那边的printf（我猜你的lib_fun里用了这个输出）缓冲规则不一样——如果是终端输出，通常是行缓冲，但要是你的C代码里输出没加换行符，或者缓冲策略是全缓冲，那C的输出就会被暂存在缓冲区里，直到程序快退出的时候才会一次性刷出来。而Rust的println!因为自带换行，直接就把内容打出来了，看起来就像是C函数的执行结果晚于Rust的输出，顺序颠倒了。

举个具体的例子，如果你的lib_fun是这么写的：

#include <stdio.h>
extern "C" int lib_fun(int i) {
    printf("from C++: %d", i); // 这里没加换行符\n
    return i;
}

那C++的输出就会卡在缓冲区里，等程序结束才会打印，而Rust的println!先一步输出，你就会先看到from Rust: 2，之后才看到from C++: 2，看起来顺序反了。

当然还有一种小概率情况：如果你的C++函数里用了异步操作或者开了线程，那函数返回后后台操作还在跑，也会导致输出顺序不对，但这种情况比较少见，先优先排查缓冲问题。

怎么解决？ #

有两个简单的办法：

• 给C++代码加缓冲刷新：要么在printf里加上换行符\n（行缓冲模式下，换行会自动触发刷新），要么每次输出后手动调用fflush(stdout);。比如修改后的C++函数：

  extern "C" int lib_fun(int i) {
      printf("from C++: %d\n", i); // 加个换行搞定
      // 或者这么写：printf("from C++: %d", i); fflush(stdout);
      return i;
  }
  

• 在Rust侧同步输出：调用完C函数后，手动刷新Rust的标准输出，不过这个主要是补漏，核心还是处理C侧的缓冲：

  use std::io::{self, Write};
  
  fn main() {
      unsafe { lib_fun(2); }
      io::stdout().flush().unwrap(); // 强制刷新Rust的输出缓冲区
      println!("from Rust: {}", 2);
  }
  

背后的机制是什么？ #

其实Rust和C/C共享同一个stdout输出流，但两者的缓冲是各自独立管理的。Rust的println!内部会自动调用刷新操作，而C/C的printf只有在遇到换行、缓冲区满，或者手动调用fflush的时候才会把缓冲区里的内容输出。当混合使用两种语言的输出时，就容易出现缓冲不同步，导致看起来执行顺序颠倒的问题。

Rust官方的FFI（外部函数接口）文档里也提到过跨语言IO的同步注意事项，核心就是要留意不同语言对标准IO的缓冲处理差异。

内容的提问来源于stack exchange，提问作者Michail