clang-cl默认调用MSVC的link.exe而非lld-link，必须显式添加-fuse-ld=lld参数（且须置于-l/-L之前）才能启用lld-link；否则即使安装了LLVM，仍会因链接器不匹配导致LNK1104、LTO失效或库找不到等问题。
clang-cl 调用 lld-link 必须显式指定 -fuse-ld=lld
Windows 下 clang-cl 默认调用 MSVC 的 link.exe，哪怕你本地装了 lld-link.exe，它也不会自动启用。这不是配置遗漏，是 Clang 的设计行为：它只在明确指示下才切换链接器。
常见错误现象包括：
- 明明装了 LLVM，但链接时仍报
LNK1104或找不到libcmt.lib - 加了
-flto却没触发链接时优化（LTO），因为 link.exe 不支持 Clang 的 LTO 格式 - 命令行里写了
lld-link，但 clang-cl 根本没调用它——它只认自己的驱动逻辑
正确做法是：在 clang-cl 命令中加入 -fuse-ld=lld，且该参数必须出现在所有 -l、-L 之前。例如：
clang-cl -fuse-ld=lld -O2 -MT -std:c++17 main.obj utils.obj -L"C:llvmlibclang.0.4libwindows" -lc++ -lc++abi -lmsvcrt -o program.exe
LIB 文件路径和顺序必须手动指定 -L 和 -l
lld-link 不识别 MSVC 的 LIB 环境变量，也不自动扫描 link.exe 默认路径（如 VC/lib）。它只按命令行中 -L 指定的路径搜索 .lib，且不支持隐式后缀补全（比如写 -lc++ 就只找 c++.lib，不会试 libc++.lib 或 libcpmt.lib）。
容易踩的坑：
-
-L路径末尾带反斜杠（）可能被 shell 吞掉，建议用正斜杠或引号包裹 -
-L必须在-l之前，否则 lld-link 完全忽略该路径 - MSVC 运行库（
msvcrt.lib、libcmt.lib）和 libc++（c++.lib）不能混用；选-MT就配libcmt.lib，选-MD就配msvcrt.lib
若用 llvm-mingw 工具链，其预置的 x86_64-w64-mingw32-clang 已内置库路径，此时可省略 -L；但原生 clang-cl 不具备该能力。
OBJ 文件格式兼容性：COFF 是前提，不能混用 ELF
lld-link 只处理 COFF 格式的 .obj，这是 Windows 原生目标格式。如果你用 GCC 或其他工具生成的是 ELF .o，lld-link 会直接报错：error: unknown file type。
验证 OBJ 格式是否合规：
- 用
file main.obj（需安装 binutils）看输出是否含COFF - 或用
llvm-readobj -file-headers main.obj，确认Machine字段为IMAGE_FILE_MACHINE_AMD64或IMAGE_FILE_MACHINE_I386
clang-cl 默认输出 COFF，但如果你在命令中误加了 --target=armv7-windows-msvc 等跨目标参数，又没配对的 toolchain，就可能产出不兼容的二进制——此时要检查 -v 输出最后一行链接命令，确认调用的是 lld-link.exe 而非 link.exe 或 ld.lld。
链接失败时最有效的排错方式：加 -v 看真实命令
lld-link 报错信息往往很简略（比如 unable to find library -lc++），但真正原因可能是路径错、大小写错、ABI 不匹配，甚至 clang-cl 根本没把它当链接器用。
唯一可靠办法是加 -v 参数，观察 clang-cl 最终执行的那条命令：
clang-cl -v -fuse-ld=lld main.obj -lc++ -o a.exe
输出末尾会类似：
"C:\Program Files\LLVM\bin\lld-link.exe" -out:a.exe ... main.obj "C:\Program Files\LLVM\lib\c++.lib"
重点核对三点：
- 调用的是
lld-link.exe，不是link.exe或ld.lld - 所有
.lib路径都已展开为绝对路径，且存在对应文件 - 没有出现
--sysroot这类 GNU ld 选项（lld-link 不支持）
如果发现调用的是 link.exe，说明 -fuse-ld=lld 位置错了、拼写错了，或者被前面的 /link 选项覆盖了——Windows 下 clang-cl 对 MSVC 风格选项优先级更高，慎用混合风格。
