Rust FFI 和 ABI 是什么关系？从一个字段写错的结构体说起

2026-10-17T23:05:00+08:00

先看一个能正常跑起来、但结果是错的例子。

插件侧编译成 cdylib，导出两个函数。cdylib 是供其他代码加载、调用的动态库产物，不要求调用方也是 Rust：

#[repr(C)]
pub struct Point {
    pub x: i32,
    pub y: i32,
}

#[no_mangle]
pub extern "C" fn point_new(x: i32, y: i32) -> Point {
    Point { x, y }
}

#[no_mangle]
pub extern "C" fn add(a: i32, b: i32) -> i32 {
    a + b
}

宿主用 Windows 的 LoadLibraryA / GetProcAddress 加载库、查找函数。它自己也定义了一个 Point，却把字段顺序写反了。下面节选类型声明和调用，symbol_address 是已查到的函数地址；完整宿主源码见后文下载链接：

#[repr(C)]
struct Point {
    y: i32,
    x: i32,
}

// 从查到的地址构造函数指针；声明由宿主自己保证正确。
let new_fn: extern "C" fn(i32, i32) -> Point = unsafe {
    std::mem::transmute(symbol_address)
};
let p = new_fn(1, 2);
println!("point_new(1,2) -> x={} y={}", p.x, p.y);

在 rustc 1.94.0、x86_64-pc-windows-msvc 环境下，这个实验打印：

add(2,3) = 5
point_new(1,2) -> x=2 y=1

没有编译错误、链接错误，也没有崩溃。插件返回的第一个整数是 1，宿主却把它当作 y；第二个整数是 2，宿主把它当作 x。

这个例子里，两个结构体的字段类型、大小和对齐恰好相同，交换字段名没有改变底层传递形状。错的是双方对这些字节的解释。它提醒我们：调用能完成，不等于接口约定一致。

本文先解释这个 Point，再看调用约定、符号、内存和失败处理。最后把它们对回上一篇《从一个 helloworld 动态库到 rpi package：ABI 插件是怎样被加载的》中的插件接口。不需要先读上一篇。

bigfish的网络博客 - FFI

Rust FFI 和 ABI 是什么关系？从一个字段写错的结构体说起