如何在Rust中通过extern函数正确链接并调用汇编代码？

一、推荐方案：使用cc crate（自动处理平台差异） #

cc crate会自动适配不同平台的汇编编译规则和符号修饰，是最稳定的实现方式。你之前分开编译两个独立库可能引发测试链接异常，合并为单个静态库即可解决问题：

修改build.rs：

fn main() {
    cc::Build::new()
        .file("asm/lib1.s")
        .file("asm/lib2.s")
        // 可选：指定汇编语法（如nasm），部分平台需显式声明
        .flag("-xassembler-with-cpp")
        .compile("asm_libs");
}

关键注意事项：

• 汇编文件中需用global 函数名暴露要给Rust调用的函数，比如x86_64 Linux下写global my_asm_func；
• Rust中必须用extern "C"块声明汇编函数，保证调用约定匹配：

  extern "C" {
      fn my_asm_func(input: u64) -> u64;
  }
  

• cc会自动处理平台符号差异（比如Windows下的下划线前缀），无需手动修改汇编代码。

二、手动编译汇编（适合精细控制场景） #

如果必须用nasm手动编译，需要解决两个核心问题：保证编译产物路径稳定，以及明确告知Cargo链接规则。你之前的方案失效，是因为目标文件生成在项目根目录，Cargo构建目录变化后无法找到，且未主动触发链接步骤。

修改build.rs：

use std::env;
use std::path::Path;
use std::process::Command;

fn main() {
    // 获取Cargo专属构建输出目录，确保路径稳定
    let out_dir = env::var("OUT_DIR").unwrap();
    let lib1_o = Path::new(&out_dir).join("lib1.o");
    let lib2_o = Path::new(&out_dir).join("lib2.o");
    let static_lib = Path::new(&out_dir).join("libasm.a");

    // 编译汇编文件为目标文件
    Command::new("nasm")
        .args(&["-f", "elf64", "-o", lib1_o.to_str().unwrap(), "asm/lib1.s"])
        .status()
        .expect("编译lib1.s失败");
    Command::new("nasm")
        .args(&["-f", "elf64", "-o", lib2_o.to_str().unwrap(), "asm/lib2.s"])
        .status()
        .expect("编译lib2.s失败");

    // 将目标文件打包为静态库，简化Cargo链接逻辑
    Command::new("ar")
        .args(&["rcs", static_lib.to_str().unwrap(), lib1_o.to_str().unwrap(), lib2_o.to_str().unwrap()])
        .status()
        .expect("创建静态库失败");

    // 告知Cargo搜索构建目录，并链接静态库
    println!("cargo:rustc-link-search=native={}", out_dir);
    println!("cargo:rustc-link-lib=static=asm");
}

关键改进点：

• 将编译产物放到OUT_DIR（Cargo维护的构建目录），避免路径不稳定问题；
• 用ar工具将多个目标文件打包为静态库，简化链接步骤；
• 通过println!("cargo:...")指令向Cargo传递链接规则，确保主程序、测试用例都能正确找到库文件。

三、你之前问题的原因分析 #

1. cc crate测试链接错误：分开编译两个独立静态库，可能导致测试阶段符号解析异常，合并为单个库即可消除该问题；
2. Command方式失效：之前的代码将目标文件生成在项目根目录，Cargo的依赖跟踪未覆盖这些文件，执行cargo clean或重新构建后路径失效，且未主动告知Cargo要链接这些文件，最终引发链接失败。

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