vscode cmake tools 的目标平台须在 cmakepresets.json 的 configurepreset 中通过 cachevariables（如 cmake_system_processor）或 environment（如 vcvarsall.bat 调用）显式声明，architecture 非标准字段；binarydir 必须唯一，避免构建混乱；编译器未找到需检查环境激活而非仅路径；launch.json 的 program 路径须与 preset 的 binarydir 一致。
VSCode CMake Tools 的 configurePreset 怎么设目标平台
目标平台不是在插件设置里选的，而是通过 CMakePresets.json 里的 configurePreset 显式声明。CMake Tools 只读这个文件，不认 VSCode 设置面板里的任何“平台”选项。
常见错误是手动在 VSCode 设置里改 cmake.generator 或 cmake.buildDirectory —— 这些字段会被 CMakePresets.json 完全覆盖，改了也无效。
-
architecture字段不是标准 CMake 预设字段，别加；平台信息必须体现在cacheVariables或environment中，比如：CMAKE_SYSTEM_PROCESSOR: "arm64" - Windows 上用 MSVC 编译 x64 目标，要确保
environment里已加载 vcvarsall.bat，或直接用visualStudio+visualStudioArchitecture字段（仅 VS 2022+ 支持） - 交叉编译时，
toolchainFile必须指向绝对路径或相对于sourceDir的有效路径，相对路径不支持${workspaceFolder}这类变量
为什么选了 preset 后 build 失败，报 “no CMAKE_CXX_COMPILER”
这说明 CMake 在 configure 阶段根本没找到编译器，不是路径错，而是工具链未激活或环境缺失。CMake Tools 不会自动帮你调用 vcvarsall.bat 或 setup-environment.sh。
- MSVC 用户：在
configurePreset的environment里显式调用，例如"VSCMD_START_DIR": "${sourceDir}"+"__VSCMD_PREINIT_PATH": "C:\Program Files\Microsoft Visual Studio\2022\BuildTools\VC\Auxiliary\Build\vcvars64.bat" - MinGW/Clang 用户：确保
PATH环境变量已包含对应bin/目录，且configurePreset中binaryDir路径不含空格或中文（Ninja 生成器对此极敏感） - 交叉编译用户：不要依赖
compilerPath字段去“指定编译器”，而应在toolchainFile中用set(CMAKE_CXX_COMPILER ...)定义，否则 CMake 仍会 fallback 到 host 编译器
launch.json 调试时找不到可执行文件，路径对不上
因为 launch.json 是静态配置，而不同平台的构建产物位置由 CMakePresets.json 中的 binaryDir 决定。硬编码路径必然失效。
- 调试前务必确认当前 active preset 已切换正确，状态栏左下角显示的
build/xxx路径要和launch.json中program字段一致 - 推荐写成：
"program": "${workspaceFolder}/build/msvc-x64-debug/myapp.exe"（Windows）或"program": "${workspaceFolder}/build/clang-arm64-release/myapp"（Linux/macOS） - 不要用
${fileDirname}/build/...这类动态路径——它指向当前打开文件的位置，不是 preset 绑定的构建目录
CMakePresets.json 里多个 preset 共用 binaryDir 会怎样
构建会静默失败或结果错乱，CMake 不会报错，但缓存、依赖检查、生成的 compile_commands.json 全部混在一起。这是最隐蔽也最常被忽略的问题。
- 每个
configurePreset的binaryDir必须唯一，哪怕只是加个后缀，例如build/x64-debug、build/arm64-release - Windows 用户尤其注意：路径中含空格（如
build/My App）会导致 Ninja 生成器跳过某些规则，最终链接失败且无明确提示 - 如果项目有 CI 流程，
binaryDir建议与 preset 名称强绑定，避免本地开发和 CI 构建目录冲突
