使用CMake与Visual Studio开发，是否必须将Clang加入系统路径？

问题核心 #

VS的CMake集成在加载CMakeSettings.json时，会优先基于指定的环境（如clang_cl_x86）初始化工具链，此时如果Clang不在系统PATH中，VS会直接报错加载配置失败——这时候你CMakeLists里设置编译器的代码根本没机会执行。而命令行环境下CMake是直接执行脚本，所以能通过CMAKE_PREFIX_PATH找到编译器。

可行解决方案 #

方案1：在CMakeSettings.json中直接注入Clang路径到环境变量 #

修改CMakeSettings.json，给目标配置添加environmentVariables字段，把你的LLVM bin目录加到PATH最前面，这样VS启动CMake时就能找到Clang：

{
  "configurations": [
    {
      "name": "x86-Debug",
      "generator": "Ninja",
      "configurationType": "Debug",
      "inheritEnvironments": [ "clang_cl_x86" ],
      "buildRoot": "${projectDir}\\out\\build\\${name}",
      "installRoot": "${projectDir}\\out\\install\\${name}",
      "cmakeCommandArgs": "",
      "buildCommandArgs": "",
      "ctestCommandArgs": "",
      "environmentVariables": {
        "PATH": "${projectDir}\\tools\\compiler\\LLVM\\bin;${env:PATH}"
      }
    }
  ]
}

注意：${projectDir}对应你在VS中打开的项目根目录，根据你的PROJECT_ROOT路径调整LLVM的绝对路径，确保指向正确的clang.exe所在目录。

方案2：直接在CMakeLists中指定编译器绝对路径 #

跳过find_path的间接查找，直接通过计算好的绝对路径设置编译器，避免环境PATH的影响：

cmake_minimum_required(VERSION 3.10)

set(PROJECT_ROOT "${CMAKE_CURRENT_SOURCE_DIR}/../../..")
set(LLVM_BIN_DIR "${PROJECT_ROOT}/tools/compiler/LLVM/bin")

# 直接校验并设置编译器
if(EXISTS "${LLVM_BIN_DIR}/clang.exe" AND EXISTS "${LLVM_BIN_DIR}/clang++.exe")
  set(CMAKE_C_COMPILER   "${LLVM_BIN_DIR}/clang.exe" CACHE PATH "" FORCE)
  set(CMAKE_CXX_COMPILER "${LLVM_BIN_DIR}/clang++.exe" CACHE PATH "" FORCE)
else()
  message(FATAL_ERROR "Clang编译器未找到，请检查路径：${LLVM_BIN_DIR}")
endif()

project(runUnitTests)

# 后续原有代码...

方案3：通过CMake命令行参数强制指定编译器 #

修改CMakeSettings.json，去掉继承的clang环境，直接在cmakeCommandArgs里传入编译器绝对路径：

{
  "configurations": [
    {
      "name": "x86-Debug",
      "generator": "Ninja",
      "configurationType": "Debug",
      "inheritEnvironments": [], // 移除自带clang环境避免冲突
      "buildRoot": "${projectDir}\\out\\build\\${name}",
      "installRoot": "${projectDir}\\out\\install\\${name}",
      "cmakeCommandArgs": "-DCMAKE_C_COMPILER=${projectDir}\\tools\\compiler\\LLVM\\bin\\clang.exe -DCMAKE_CXX_COMPILER=${projectDir}\\tools\\compiler\\LLVM\\bin\\clang++.exe",
      "buildCommandArgs": "",
      "ctestCommandArgs": ""
    }
  ]
}

补充说明 #

你之前遇到的“删除out文件夹才复现问题”，是因为out目录里缓存了CMake生成的配置文件，里面已经记录了编译器的绝对路径，所以即使后续移除系统PATH也能正常构建；但删除缓存后，VS重新初始化配置时又找不到Clang，就会触发报错。

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