vscode中cmake报错需分三步排查：先确认系统已安装cmake并正确配置path；再检查c++编译器（g++/clang++/cl.exe）是否存在并选择对应kit；最后确保configure、build、run步骤依次执行且路径、环境变量、架构设置正确。
找不到 cmake 命令或提示“CMake not found”
VSCode 本身不自带 CMake，CMake Tools 插件只是调度器，真正干活的是你系统里装的 cmake 可执行文件。如果终端能运行 cmake --version，但 VSCode 里报错，大概率是环境变量没继承进来。
实操建议：
- Windows 用户优先装
choco install cmake或从官网下带 GUI 的安装包（勾选「Add CMake to system PATH」） - macOS 用户用
brew install cmake，别用 MacPorts；装完检查which cmake输出是否在/opt/homebrew/bin/cmake或/usr/local/bin/cmake - Linux 用户确认
/usr/bin/cmake存在，或手动在 VSCode 设置里加"cmake.cmakePath": "/path/to/cmake" - 重启 VSCode —— 插件启动时只读一次 shell 环境，改完 PATH 不重启无效
configure 失败：No CMAKE_CXX_COMPILER could be found
这是 C++ 项目最常卡住的地方：CMake 知道要编译 C++，但找不到 g++、clang++ 或 cl.exe。不是插件问题，是工具链没就位。
实操建议：
- 先在终端跑
g++ --version或clang++ --version，确认编译器可用；Windows 用 Visual Studio 的话，必须装好「Desktop development with C++」工作负载 - VSCode 里按
Ctrl+Shift+P→ 输入CMake: Select a Kit，选中带g++、Clang或Visual Studio字样的 kit；没选项？点「Scan for kits」再试 - 如果 kit 列表为空，Windows 用户检查是否装了
Build Tools for Visual Studio（比完整 VS 轻量，且自带cl.exe） - Linux/macOS 用户注意：某些发行版（如 Ubuntu）默认不装
build-essential，得先sudo apt install build-essential
build 成功但 run 报错：找不到动态库或 exec format error
构建成功只代表编译链接过了，不代表程序能直接跑。常见于路径没设对、依赖没加载、或架构不匹配（比如在 Apple Silicon 上用 x86_64 编译器生成了错误二进制）。
实操建议：
- 检查
launch.json里的program路径是否指向build/xxx下刚生成的可执行文件（不是src/里的源码） - Linux/macOS 下如果用了
find_package引入第三方库（如OpenCV），运行前可能需要export LD_LIBRARY_PATH=/path/to/lib:$LD_LIBRARY_PATH；VSCode 的launch.json支持env字段写进去 - macOS 上遇到
exec format error，八成是 CMake 用了错误的CMAKE_OSX_ARCHITECTURES；在CMakeLists.txt里显式加set(CMAKE_OSX_ARCHITECTURES "arm64")或删掉该设置让系统自动推断 - 别依赖「Run Without Debugging」按钮——它不读
launch.json，容易忽略环境变量和工作目录，老实用F5启动调试
修改 CMakeLists.txt 后配置没更新，还是旧行为
CMake Tools 默认不会自动重配置，尤其当你改了 project()、add_executable() 或 target_link_libraries() 这类关键指令后，缓存仍会沿用旧逻辑。
实操建议：
- 改完
CMakeLists.txt，务必手动触发CMake: Configure（快捷键Ctrl+Shift+P→ 输入该命令），不能只点「Build」 - 如果 configure 没反应，看右下角状态栏有没有显示 kit 和 build type（如
gcc x64 Debug）；没有的话先选 kit，再 configure - 真遇到诡异缓存（比如删了
add_library但还能 link 到旧库），直接删掉build/目录再 configure —— CMake 的 out-of-source 构建就是干这个用的，别心疼 - 想每次保存自动 configure？可以开
"cmake.autoConfigureOnOpen": true，但不推荐新手开，容易掩盖路径或语法错误
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
