Windows下CMAKE_TOOLCHAIN_FILE无效，CMake仍调用MSVC编译器问题

问题背景 #

Windows 10环境下已安装MSVS 2022、Clang LLVM，使用VSCode和CMake 3.23.2。执行以下命令后，CMake仍识别MSVC为编译器并生成VC工程文件：

mkdir build
cd build
cmake -D CMAKE_TOOLCHAIN_FILE="..\cmaketoolchain.win10clang" ..

工具链文件cmaketoolchain.win10clang内容：

set(CMAKE_C_COMPILER "clang")
set(CMAKE_CXX_COMPILER "clang++")

SET (CMAKE_C_COMPILER             "d:\\Program Files\\LLVM\\bin\\clang.exe")
SET (CMAKE_C_FLAGS                "-Wall -std=c99")
SET (CMAKE_C_FLAGS_DEBUG          "-g")
SET (CMAKE_C_FLAGS_MINSIZEREL     "-Os -DNDEBUG")
SET (CMAKE_C_FLAGS_RELEASE        "-O4 -DNDEBUG")
SET (CMAKE_C_FLAGS_RELWITHDEBINFO "-O2 -g")

SET (CMAKE_CXX_COMPILER             "d:\\Program Files\\LLVM\\bin\\clang++.exe")
SET (CMAKE_CXX_FLAGS                "-Wall")
SET (CMAKE_CXX_FLAGS_DEBUG          "-g")
SET (CMAKE_CXX_FLAGS_MINSIZEREL     "-Os -DNDEBUG")
SET (CMAKE_CXX_FLAGS_RELEASE        "-O4 -DNDEBUG")
SET (CMAKE_CXX_FLAGS_RELWITHDEBINFO "-O2 -g")

CMake输出片段：

cmake -D CMAKE_TOOLCHAIN_FILE="..\cmaketoolchain.win10clang" ..
-- Building for: Visual Studio 17 2022
-- Selecting Windows SDK version 10.0.19041.0 to target Windows 10.0.19043.
-- The C compiler identification is MSVC 19.31.31104.0
-- The CXX compiler identification is MSVC 19.31.31104.0
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working C compiler: d:/Program Files/Microsoft Visual Studio/2022/Community/VC/Tools/MSVC/14.31.31103/bin/Hostx64/x64/cl.exe - skipped
-- Detecting C compile features
-- Detecting C compile features - done
-- Detecting CXX compiler ABI info
...

问题原因 #

1. 默认生成器优先级：Windows环境下CMake默认使用Visual Studio生成器，该生成器会强制关联MSVC工具链，后续指定的Clang路径会被覆盖。
2. 工具链文件执行时机：CMake先初始化生成器、绑定MSVC后，才会加载工具链文件，此时编译器配置已锁定。

解决方法 #

方法1：显式指定兼容Clang的生成器 #

执行CMake时直接指定生成器为Ninja（需提前安装Ninja并加入系统环境变量）：

cmake -G Ninja -D CMAKE_TOOLCHAIN_FILE="..\cmaketoolchain.win10clang" ..

若需保留Visual Studio的工程结构并使用Clang，可指定ClangCL工具集：

cmake -G "Visual Studio 17 2022" -T ClangCL -D CMAKE_TOOLCHAIN_FILE="..\cmaketoolchain.win10clang" ..

方法2：修改工具链文件强制锁定编译器 #

在工具链文件开头添加以下配置，跳过CMake的自动编译器检测逻辑：

# 强制使用指定编译器，禁用自动检测
set(CMAKE_C_COMPILER_FORCED TRUE)
set(CMAKE_CXX_COMPILER_FORCED TRUE)

# 可选：指定生成器为Ninja（如果需要）
set(CMAKE_GENERATOR "Ninja" CACHE INTERNAL "" FORCE)

方法3：提升Clang在环境变量中的优先级 #

在执行CMake前，将Clang的bin目录临时加入PATH最前端，让CMake优先找到Clang：

$env:PATH = "d:\Program Files\LLVM\bin;" + $env:PATH
cmake -D CMAKE_TOOLCHAIN_FILE="..\cmaketoolchain.win10clang" ..

验证标准 #

执行CMake后，若输出中出现以下内容，说明配置成功：

-- The C compiler identification is Clang X.X.X
-- The CXX compiler identification is Clang X.X.X

此时生成的将是对应生成器的工程文件（如Ninja的build.ninja），而非VC工程文件。

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