Rust调用C库编译报错：ld无法找到-lsynctex_parser

错误原因分析 #

macOS链接器默认查找命名为libxxx.dylib或libxxx.so的库，你的共享库名为synctex_parser.so（缺少lib前缀），导致链接器执行-lsynctex_parser时无法匹配到对应文件；同时macOS对.dylib后缀的共享库支持更友好，.so后缀可能引发工具链识别问题。

解决方案 #

方案一：规范库命名（推荐） #

1. 重命名共享库：将src/so/synctex_parser.so改为src/so/libsynctex_parser.dylib（macOS标准后缀），或src/so/libsynctex_parser.so。
2. 保持Rust代码不变：原代码中的#[link(name = "synctex_parser")]无需修改，因为-lsynctex_parser会自动匹配libsynctex_parser.dylib/libsynctex_parser.so。
3. 编译命令优化：
   直接执行以下命令编译：

   RUSTFLAGS='-L ./src/so' cargo build
   

   或者创建项目根目录的.cargo/config.toml文件，添加配置后无需每次输入RUSTFLAGS：

   [build]
   rustflags = ["-L", "./src/so"]
   

   之后直接运行cargo build即可。

方案二：不修改库名，手动指定链接参数 #

如果不想修改库名，可通过链接参数强制指定库文件：

1. 修改Rust代码：移除#[link(name = "synctex_parser")]属性，代码变为：

   use std::os::raw::{c_int, c_char};
   
   extern "C" {
       pub fn synctex_scanner_new_with_output_file(output: c_char, build_directory: c_char, parse: c_int);
   }
   

2. 执行编译命令：

   RUSTFLAGS='-C link-args="-L ./src/so -l:synctex_parser.so"' cargo build
   

   其中-l:synctex_parser.so用于告诉链接器直接查找指定文件名，而非自动添加lib前缀。

额外注意事项 #

• 若后续运行时出现库找不到的问题，可在编译时添加rpath参数，确保运行时能定位到库：

  RUSTFLAGS='-L ./src/so -C link-args="-Wl,-rpath,$(pwd)/src/so"' cargo build
  

• 确认共享库的编译架构为aarch64-apple-darwin，与你的Rust工具链架构一致，避免后续出现架构不匹配错误。

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