编译Rust静态库并在C++中调用：出现未定义引用错误

我帮你梳理一下从Rust静态库编译到C++调用的完整正确流程，顺便排查你可能踩的坑：

1. 补全并修正Cargo.toml配置 #

你的配置缺少了最关键的静态库声明，必须显式指定crate-type为staticlib，否则Rust默认生成的是仅Rust可用的库。完整配置如下：

[package]
name = "hello_world"
version = "0.1.0"
edition = "2021"  # 指定Rust版本，避免兼容性问题

[lib]
name = "hello_in_rust_lib"
path = "src/lib.rs"
crate-type = ["staticlib"]  # 核心！声明生成C兼容的静态库

2. 编写正确的Rust库代码（src/lib.rs） #

要让C++能识别Rust函数，必须禁用Rust的名称修饰，并使用C风格的调用约定：

// 禁用名称修饰，让C++能找到函数符号
#[no_mangle]
// 用extern "C"指定C调用约定
pub extern "C" fn hello_from_rust() {
    println!("Hello from Rust static library!");
}

// 带参数和返回值的示例，必须用C兼容的基础类型
#[no_mangle]
pub extern "C" fn add(a: i32, b: i32) -> i32 {
    a + b
}

3. 编译Rust静态库 #

执行编译命令生成release版本（性能更好、体积更小）：

cargo build --release

编译完成后，静态库的位置：

• Linux/macOS：target/release/libhello_in_rust_lib.a
• Windows（MSVC工具链）：target/release/hello_in_rust_lib.lib
• Windows（MinGW工具链）：target/release/libhello_in_rust_lib.a

4. 编写C++调用代码（示例：main.cpp） #

必须用extern "C"包裹Rust函数的声明，避免C++的名称修饰破坏符号匹配：

#include <iostream>

// 声明Rust导出的函数，用extern "C"匹配调用约定和符号
extern "C" {
    void hello_from_rust();
    int add(int a, int b);
}

int main() {
    std::cout << "Calling Rust functions from C++:\n";
    hello_from_rust();
    
    int result = add(3, 5);
    std::cout << "3 + 5 = " << result << "\n";
    
    return 0;
}

5. 编译C++代码并链接静态库 #

分平台操作：

Linux/macOS（使用g++） #

g++ main.cpp -o cpp_call_rust -L./target/release -lhello_in_rust_lib

• -L：指定静态库所在目录
• -l：指定库名（自动去掉前缀lib和后缀.a）

运行程序：

./cpp_call_rust

Windows（MSVC编译器，如Visual Studio命令行） #

cl main.cpp /link target\release\hello_in_rust_lib.lib

如果用MinGW的g++：

g++ main.cpp -o cpp_call_rust.exe -L./target/release -lhello_in_rust_lib

常见错误排查 #

• 忘记设置crate-type = ["staticlib"]：这是最容易踩的坑！默认生成的rlib仅能被Rust项目引用，C++无法识别。
• 缺少#[no_mangle]：Rust编译器会给函数名添加哈希前缀，导致C++找不到对应符号。
• 调用约定不匹配：Rust和C++两边都必须用extern "C"声明，否则会出现栈损坏或调用错误。
• 链接时找不到库：确保-L指定的路径正确，库名拼写无误（注意Linux/macOS的libxxx.a对应-lxxx）。
• 工具链不兼容：Windows下如果Rust用MSVC工具链编译，C也要用MSVC；如果用MinGW工具链，C也要对应使用MinGW，否则链接会失败。

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