build variant 是 cmake tools 插件对构建配置的封装，本质是一组预设的 configureargs、buildargs 和 environment 组合；它解决同一份源码下编译宏、工具链、输出路径等快速切换问题，而仅在 cmakelists.txt 中定义多个 add_executable 无法实现该能力，因为 cmake configure 阶段已固化构建树结构。
Build Variant 是什么，为什么不能只靠 CMakeLists.txt 里写多个 add_executable
Build Variant 不是 CMake 原生概念，而是 CMake Tools 插件对构建配置的封装——它本质是一组预设的 cmake.configureArgs、cmake.buildArgs 和 cmake.environment 组合。只在 CMakeLists.txt 里定义多个可执行目标，无法解决「同一份源码、不同编译宏/工具链/输出路径」的快速切换问题，因为 CMake configure 阶段就已固化了整个构建树的结构。
如何在 settings.json 中正确定义 Build Variant
必须把 variant 配置写在工作区根目录下的 .vscode/settings.json（不是用户级设置），且 key 必须为 cmake.buildVariants。常见错误是拼错 key 名（如写成 buildVariant 或 cmake.variants）或把配置放在全局 settings.json 中导致不生效。
-
"cmake.buildVariants"的值是一个对象，key 是 variant 名（如"debug-clang"），value 是包含configureArgs、buildArgs、environment的子对象 -
configureArgs里可传-DCMAKE_BUILD_TYPE=Debug、-DCMAKE_C_COMPILER=clang等；buildArgs通常只填["--config", "Debug"]（MSVC）或空数组（Ninja/Make） -
environment用于注入临时环境变量，比如{"CC": "/usr/bin/clang"}，注意 Windows 下路径需用正斜杠或双反斜杠
示例：
{
"cmake.buildVariants": {
"debug-gcc": {
"configureArgs": ["-DCMAKE_BUILD_TYPE=Debug", "-DCMAKE_C_COMPILER=gcc"],
"buildArgs": []
},
"release-clang": {
"configureArgs": ["-DCMAKE_BUILD_TYPE=Release", "-DCMAKE_C_COMPILER=clang"],
"buildArgs": [],
"environment": {"CC": "clang"}
}
}
}
切换 Variant 后，为什么没自动重新 configure？
CMake Tools 不会在切换 Variant 时自动触发 configure，这是设计使然：Variant 只是配置模板，是否应用取决于你是否手动触发 CMake: Configure（快捷键 Ctrl+Shift+P → 输入该命令）。容易误以为“选了 Variant 就生效”，结果还在跑旧构建树。
- 每次切换 Variant 后，务必手动执行一次
CMake: Configure - 如果之前已有 build 目录，CMake Tools 默认复用它；但不同 Variant 往往需要独立 build 目录，否则会冲突。建议在
configureArgs中显式指定-B，例如"-Bbuild/debug-gcc" - 可通过
cmake.clearOutputBeforeBuild设为true避免残留产物干扰，但更推荐用分离的 build 目录
运行时怎么确保启动的是当前 Variant 构建出的二进制？
CMake Tools 的 CMake: Run Without Debugging 或调试启动，默认使用 cmake.executables 中第一个 executable 的 name 字段匹配构建产物路径。但如果你有多个 add_executable(myapp ...)，而 Variant 切换只改变编译参数不改变 target 名，那所有 Variant 都会输出到同一个路径（如 build/myapp），导致运行结果不可控。
- 解决方案：在
CMakeLists.txt中用set_target_properties动态设置OUTPUT_NAME，例如：set_target_properties(myapp PROPERTIES OUTPUT_NAME "myapp_${CMAKE_BUILD_TYPE}_${CMAKE_C_COMPILER_ID}") - 或者，在每个 Variant 的
configureArgs中加-DCMAKE_RUNTIME_OUTPUT_DIRECTORY=build/${variant_name}，再配合cmake.executables显式指定路径 - 检查当前激活的构建目录路径是否与你预期一致：状态栏左下角显示的 “Build” 路径必须和你 configure 时指定的
-B匹配
-B 路径管理、OUTPUT_NAME 控制、以及 configure 手动触发这三点最容易被跳过——漏掉任一环节，切换就只是“看起来换了”。
