Windows/Ubuntu下链接LLVM遇缺失库及损坏rlibs问题

这些平台特定问题主要源于LLVM二进制构建的配置差异，部分涉及链接器适配问题，以下逐个拆解并给出解决方案：

1. MacOS Aarch64/本地Ubuntu：ld: library 'zstd' not found #

• 根源：LLVM构建时启用了zstd依赖，但构建产物未静态链接zstd，且未配置链接器搜索路径。即使系统安装zstd，也可能因架构不匹配（如MacOS Aarch64的zstd与LLVM架构不符）或链接器路径缺失导致找不到。
• 修复：
  • 重新构建LLVM时添加-DLLVM_ENABLE_ZSTD=OFF禁用zstd依赖；或启用静态链接：-DLLVM_STATIC_LINK_CXX_STDLIB=ON，确保LLVM不依赖系统zstd。
  • 若保留zstd，在build.rs中手动指定zstd库路径与链接规则：

    println!("cargo:rustc-link-search=native=/path/to/zstd/lib");
    println!("cargo:rustc-link-lib=zstd");
    

2. MacOS x86（MacOS 13）：无异常 #

该架构下LLVM构建时zstd被静态链接，或系统自带zstd版本与LLVM依赖完全匹配，属于构建巧合适配，不代表整体构建流程无问题。

3. Windows：rust-lld报错truncated or malformed archive #

• 根源：LLVM构建生成的静态库格式损坏，或Windows下构建时使用的归档工具与rust-lld不兼容。
• 修复：
  • 重新构建Windows版LLVM，使用LLVM自带的llvm-ar生成静态库，避免使用系统默认ar工具。
  • 检查库文件拷贝过程，用robocopy替代普通拷贝，防止文件截断。

4. 远程Ubuntu：ExecutionEngine函数找不到 #

• 根源：LLVM构建时未启用ExecutionEngine组件，或组件符号未正确导出到静态库。即便添加了链接标志，若构建阶段未编译该组件代码，自然找不到对应符号。
• 修复：
  • 检查LLVM构建参数，确保启用ExecutionEngine：-DLLVM_ENABLE_PROJECTS=executionengine（注意不同LLVM版本组件名称可能有差异），静态构建时需确保该组件被包含进产物。
  • 在build.rs中确认链接对应库：

    println!("cargo:rustc-link-lib=LLVMExecutionEngine");
    

    部分LLVM版本库名带版本号，需调整为LLVMExecutionEngine-XX（XX为版本号）。

通用优化建议 #

• 统一跨平台LLVM构建参数：禁用不必要的第三方依赖，强制静态链接所有依赖，消除平台差异。
• 验证构建产物：用nm（Linux/Mac）或dumpbin（Windows）检查静态库是否包含目标符号，提前排查缺失问题。
• 动态适配链接脚本：在build.rs中根据不同平台生成对应链接规则，处理Windows/Linux/Mac的库格式、命名差异。

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