使用Clang+CMake编译时遇Address Sanitizer版本不匹配及链接错误

问题根源 #

Clang 15.x在MSVC CLI环境中启用ASan时，无法自动关联VS安装的ASan库，导致链接阶段缺失__asan_init、__asan_version_mismatch_check_v8、__asan_shadow_memory_dynamic_address等核心符号，最终CMake配置失败。

解决方案 #

• 显式传递ASan编译/链接参数
  在CMake配置时，直接添加ASan相关标志：

  set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -fsanitize=address")
  set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fsanitize=address")
  set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -fsanitize=address")
  

  或者通过命令行参数传递：

  cmake .. -DCMAKE_C_FLAGS="-fsanitize=address" -DCMAKE_CXX_FLAGS="-fsanitize=address" -DCMAKE_EXE_LINKER_FLAGS="-fsanitize=address"
  

• 手动链接VS ASan库
  找到VS 2022安装路径下的ASan库（路径示例：C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\17.5.33516.290\lib\x64\clang_rt.asan_dynamic-x86_64.lib），在CMake中手动关联：

  target_link_libraries(你的目标名称 PRIVATE "C:/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/MSVC/17.5.33516.290/lib/x64/clang_rt.asan_dynamic-x86_64.lib")
  

• 切换至Clang原生ASan
  若VS适配的ASan存在兼容问题，改用Clang自带的ASan组件。确保Clang完整安装后，指定Clang工具链：

  cmake .. -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++ -DCMAKE_C_FLAGS="-fsanitize=address" -DCMAKE_CXX_FLAGS="-fsanitize=address"
  

• 确保环境变量正确加载
  运行VS开发者命令提示符后再执行CMake，保证VS工具链路径、ASan库路径被正确识别。

验证方式 #

编译并运行以下测试代码，若ASan输出内存越界报告，说明配置成功：

#include <stdlib.h>
int main() {
    char *ptr = malloc(10);
    ptr[10] = 'a'; // 触发内存越界
    free(ptr);
    return 0;
}

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