vscode本身不提供cmake构建能力，所有构建均依赖本地安装的cmake可执行文件和配套编译器；cmake tools插件仅作为调度器，需确保系统级工具链就位、环境变量正确继承、kit选择准确，并在修改path或安装工具后重启vscode。
VSCode 本身不提供 CMake 构建能力，所有构建动作都依赖你本地安装的 cmake 可执行文件和配套编译器；插件 CMake Tools 只是调度器，不是构建器。
确认系统级工具链已就位
VSCode 报 “CMake not found” 或 “No CMAKE_CXX_COMPILER could be found”，90% 是因为终端能跑、但 VSCode 没继承到环境变量，或根本没装对东西。
- 在终端运行
cmake --version和g++ --version（Linux/macOS）或cl.exe（Windows MSVC），必须都返回有效版本号 - Windows 用户若用 MinGW，确保
mingw32-make或ninja在PATH中；若用 Visual Studio，必须安装「Desktop development with C++」工作负载 - macOS 用户装完 Xcode Command Line Tools 后，再跑
sudo xcode-select --switch /Library/Developer/CommandLineTools避免路径错乱 - Linux 用户别跳过
sudo apt install build-essential（Ubuntu/Debian）或sudo dnf groupinstall "Development Tools"（Fedora）
CMake Tools 插件必须选对 Kit
CMake: Select a Kit 不是走个过场——它直接决定 cmake 调用哪个编译器、生成哪种构建系统（Ninja/Make/Visual Studio）、甚至影响 ABI 兼容性。
- 按
Ctrl+Shift+P→ 输入CMake: Select a Kit，优先选带明确编译器标识的项，例如Clang 16.0.6 (x86_64)或GCC 13.2.0 (MinGW) - 如果列表为空，先点
Scan for kits；Windows 上没扫描出 MSVC Kit，说明 Build Tools for Visual Studio 没装，或安装时漏选了 C++ 组件 - Kit 选错会导致后续
configure失败，或生成的二进制在运行时报exec format error（比如 Apple Silicon 上用了 x86_64 编译器）
configure 失败常见原因与绕过方式
报错如 CMake Error: No CMAKE_CXX_COMPILER could be found 或 Could not find a package configuration file，本质是 CMake 找不到工具或依赖描述文件。
- 检查
CMakeLists.txt开头是否写了project(... LANGUAGES CXX)；漏写CXX会导致 CMake 默认只找 C 编译器 - 第三方库（如 OpenCV）未安装时，
find_package(OpenCV REQUIRED)必然失败；可临时注释掉，或提前用brew install opencv/apt install libopencv-dev安装 - 某些旧项目用
set(CMAKE_BUILD_TYPE "Debug")但没设默认值，导致 configure 卡住；可在 VSCode 命令面板中手动触发CMake: Set Build Type先选一次 - Windows 上用 Ninja 但没装
ninja，会 fallback 到 Makefiles 并报错；直接装choco install ninja或从官网下二进制加进PATH
build 成功但 run 不起来？重点查 launch.json 和环境变量
构建成功只代表链接通过，不代表程序能加载运行。动态库缺失、路径错误、架构不匹配都会让 F5 启动失败。
-
launch.json中的program字段必须指向build/目录下真实生成的可执行文件，不能写成src/main.cpp或相对路径错误 - Linux/macOS 下若用
find_package引入非系统库（如自己编译的 Boost），需在launch.json的env字段显式加"LD_LIBRARY_PATH": "/path/to/boost/lib:$LD_LIBRARY_PATH" - macOS 上
exec format error几乎一定是CMAKE_OSX_ARCHITECTURES设错；在CMakeLists.txt顶部加set(CMAKE_OSX_ARCHITECTURES "arm64")（Apple Silicon）或"x86_64"（Intel） - VSCode 的
launch.json不继承 shell 的PATH，所以即使终端里gdb --version可用，调试器仍可能找不到——建议在launch.json里用miDebuggerPath显式指定完整路径，如/usr/bin/gdb
最常被忽略的一点：CMake Tools 插件启动时只读一次 shell 环境变量，改完 PATH 或装完工具后，必须重启 VSCode 才生效；否则所有配置都是徒劳。
