在WSL2中用Clang/LLVM交叉编译Windows二进制文件遇链接错误

问题根源 #

启用-fsanitize=address,undefined后，Clang默认会去Linux系统路径（比如/usr/lib64）查找sanitizer运行时库，但交叉编译Windows目标时，我们需要的是Windows版本的Clang sanitizer库——也就是你提到的MSVC路径里的clang_rt.asan系列文件。必须强制引导链接器指向正确的库路径，避免它误搜Linux系统库。

具体解决步骤 #

1. 修改CMake工具链文件，指定Sanitizer库路径 #

打开你的Windows交叉编译工具链文件（比如命名为toolchain-windows.cmake），添加以下配置：

# 启用Sanitizer时的专属配置
if(SANITIZE)
  # 添加编译与链接层面的Sanitizer选项
  add_compile_options(-fsanitize=address,undefined)
  add_link_options(-fsanitize=address,undefined)

  # 替换为你本地MSVC lib的实际路径，示例：/mnt/c/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/MSVC/14.38.33130/lib/x64
  set(SANITIZER_LIB_PATH "/mnt/c/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/MSVC/<你的MSVC版本号>/lib/<目标架构，如x64>")
  link_directories(${SANITIZER_LIB_PATH})

  # 明确指定要链接的Windows版Sanitizer库，根据架构和CRT模式调整：
  # 示例为x64+动态CRT（/MD）的组合
  target_link_libraries(你的目标程序名称 PRIVATE
    clang_rt.asan_dynamic-x86_64
    clang_rt.asan_dynamic_runtime_thunk-x86_64
    clang_rt.ubsan_standalone-x86_64
  )
endif()

2. 强制使用LLD链接器，避免误搜Linux库 #

执行CMake时添加额外参数，指定用LLD链接器，它会严格遵循你设置的路径查找库，不会乱搜Linux系统目录：

cmake .. -DCMAKE_TOOLCHAIN_FILE=toolchain-windows.cmake -DSANITIZE=ON -DCMAKE_EXE_LINKER_FLAGS="-fuse-ld=lld"

3. 确认Sanitizer库版本匹配 #

MSVC路径下的clang_rt.asan库分静态/动态、不同架构版本，需对应你的编译配置：

• 若使用静态CRT（/MT），选择不带_dynamic的库，比如clang_rt.asan-x86_64.lib
• 若使用动态CRT（/MD），选择带_dynamic的库，比如clang_rt.asan_dynamic-x86_64.lib
• Undefined Behavior Sanitizer对应clang_rt.ubsan_standalone-x86_64.lib或带动态后缀的版本

4. 确保工具链目标平台设置正确 #

工具链文件中必须明确指定目标为Windows，防止Clang混淆编译平台：

set(CMAKE_SYSTEM_NAME Windows)
set(CMAKE_SYSTEM_PROCESSOR x86_64)

# 指定Clang交叉编译目标前缀
set(CMAKE_C_COMPILER clang)
set(CMAKE_CXX_COMPILER clang++)
set(CMAKE_C_COMPILER_TARGET x86_64-w64-mingw32)
set(CMAKE_CXX_COMPILER_TARGET x86_64-w64-mingw32)

验证方案 #

启用SANITIZE=ON编译HelloWorld程序，检查链接器日志是否显示从MSVC路径加载sanitizer库。若使用动态版本的sanitizer库，运行Windows二进制时需确保系统中存在对应的动态库；静态版本则无需额外依赖。

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