clang交叉编译默认不调用lld,需显式指定-fuse-ld=lld(且置于-l/-l前),并配合-l指定sysroot库路径,因lld不自动识别--sysroot;不同平台对应lld、lld-link或wasm-ld,须验证-v输出确认生效。

交叉编译时 clang 默认不调用 lld,必须显式指定
clang 在交叉编译场景下(比如 clang -target aarch64-linux-gnu)仍默认调用系统 ld 或 link.exe,而不是同属 LLVM 的 lld。这不是 bug,是设计使然:clang 只在明确指示下才切换链接器。
常见错误现象包括:
- 报错
ld: unknown option --gc-sections(GNU ld 选项被传给 LLD) - 链接失败并提示
cannot find -lc(LLD 没有自动搜索交叉 libc 路径) - Windows 下静默调用 MSVC 的
link.exe,完全绕过lld-link.exe
解决方法统一为:在 clang 命令中加入 -fuse-ld=lld,且该参数必须出现在所有 -l、-L 之前。
示例(ARM64 Linux 交叉链接):
clang -target aarch64-linux-gnu \ -fuse-ld=lld \ -L/path/to/sysroot/usr/lib \ -I/path/to/sysroot/usr/include \ main.o utils.o \ -lc -lm -o program
lld 在不同平台对应不同可执行文件名
LLD 不是单一二进制,而是按目标格式分发的多个工具:
- Linux/ELF 目标 → 使用
lld(或ld.lld),命令行传-fuse-ld=lld - Windows/COFF 目标 → 必须用
lld-link.exe,命令行传-fuse-ld=lld仍有效,但 clang 会自动映射到lld-link - macOS/Mach-O 目标 →
ld64.lld,但 clang 当前对 macOS 交叉支持弱,一般不用于跨平台构建 - WebAssembly →
wasm-ld,需用-fuse-ld=wasm-ld显式指定
验证是否真正生效:加 -v 参数看 clang 输出的最后一行链接命令,确认调用的是 lld 还是 link.exe 或 ld。
交叉链接时 lld 不自动识别 sysroot,-L 和 --sysroot 都要配
GNU ld 支持 --sysroot=/path 自动将 /path/usr/lib、/path/lib 等加入库搜索路径;而 lld 对 --sysroot 的支持有限,尤其在 COFF/ELF 混合场景下常忽略它。
实操建议:
- 始终显式添加
-L/path/to/sysroot/usr/lib和-L/path/to/sysroot/lib - 对 C++ 项目,额外加
-L/path/to/sysroot/usr/lib/gcc/<triplet>/<version></version></triplet> -
--sysroot仍要传,因为 clang 前端需要它定位头文件,但不能指望它帮 lld 找库 - 若用
llvm-mingw工具链,其x86_64-w64-mingw32-clang已预置好库路径,此时-L可省略
漏掉 -L 的典型错误:lld: error: unable to find library -lc,即使 libc.a 就在 sysroot/usr/lib 下。
LLD 的 -rpath-link 和 --allow-multiple-definition 行为与 GNU ld 不同
交叉链接裸机或嵌入式固件时,常需绕过符号重复定义或手动控制运行时库搜索路径。LLD 在这些开关上的语义更严格:
-
-rpath-link:LLD 仅在动态链接时生效(即生成.so或可执行文件含 DT_RUNPATH),静态链接(--static)下完全忽略。GNU ld 则会用它辅助解析未定义符号。 -
--allow-multiple-definition:LLD 默认允许,GNU ld 默认拒绝;但若你依赖此行为做弱符号覆盖,需确认目标格式支持——COFF(Windows)下该选项无效,必须用__declspec(selectany)替代。 -
--undefined:LLD 要求显式列出符号名,不支持通配符;GNU ld 支持--undefined=*。
最容易被忽略的一点:LLD 对链接脚本中 SECTIONS 里 *(.text) 这类通配符匹配更保守,若输入目标文件用了自定义段名(如 .text.isr),需在脚本中明确写出,不能依赖隐式合并。











