如何在Rust中链接自定义动态(.so)库？相关疑问解答

1. 为什么必须用-L参数？ #

你在build.rs里只通过println!("cargo:rustc-link-arg=-lawesome");告诉链接器要链接libawesome.so，但链接器不知道这个库的具体位置。默认情况下，链接器只会在系统标准库路径（如/usr/lib、/lib）里查找动态库，而你的libawesome.so在自定义路径/path/to/library/build下，所以必须通过-L参数告诉rustc（以及底层的链接器）去这个自定义路径搜索库文件，否则链接器找不到目标库，会直接报错。

2. 不借助RUSTFLAGS实现链接的方法 #

完全可以通过build.rs配置所有链接参数，不用在命令行里传RUSTFLAGS，具体修改如下：

修改你的build.rs，添加库搜索路径、指定链接的动态库，同时设置运行时搜索路径（rpath）：

// 指定动态库所在的搜索路径
println!("cargo:rustc-link-search=native=/path/to/library/build");
// 链接动态库（推荐用这种方式替代直接传-link-arg）
println!("cargo:rustc-link-lib=dylib=awesome");
// 设置运行时rpath，确保程序运行时能找到动态库
println!("cargo:rustc-link-arg=-Wl,-rpath=/path/to/library/build");

这样修改后，直接运行cargo test就能正常完成链接并执行测试，不需要额外设置RUSTFLAGS。

几个核心指令的作用：

• cargo:rustc-link-search=native=PATH：等价于给rustc传递-L PATH参数，明确告知库文件的搜索路径。
• cargo:rustc-link-lib=dylib=awesome：这是Cargo推荐的链接动态库的方式，比直接传-lawesome更规范，还能自动适配不同平台的库命名规则（比如Windows下的.dll、macOS下的.dylib）。
• cargo:rustc-link-arg=-Wl,-rpath=PATH：给链接器传递rpath参数，保证程序运行时能定位到自定义路径下的动态库。

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