CMake Tools插件本身不提供CMake或编译器，仅调度本地已安装工具链；配置失败90%源于环境未就位，而非插件或VSCode问题：需确保cmake命令在VSCode继承的PATH中可用、正确选择含编译器标识的Kit、CMakeLists.txt启用调试符号（如set(CMAKE_BUILD_TYPE Debug)）、launch.json中program路径指向build下真实可执行文件，且c_cpp_properties.json通过compile_commands.json自动同步头路径。
CMake Tools 插件本身不提供 CMake 或编译器，只调度你本地已装好的工具链；配置失败 90% 是环境没就位，不是插件或 VSCode 的问题。
VSCode 找不到 cmake 命令
终端能跑 cmake --version，但 VSCode 里报 “CMake not found”，说明插件没继承 shell 的 PATH。插件启动时只读一次环境变量，改完 PATH 不重启 VSCode 就无效。
- Windows 用户优先用
choco install cmake，或官网下载带 GUI 的安装包，安装时务必勾选「Add CMake to system PATH」 - macOS 用户用
brew install cmake，检查which cmake输出是否为/opt/homebrew/bin/cmake（Apple Silicon）或/usr/local/bin/cmake（Intel） - Linux 用户确认
/usr/bin/cmake存在；若装在别处（如/opt/cmake/bin/cmake），必须在 VSCode 设置里手动填"cmake.cmakePath": "/opt/cmake/bin/cmake"
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，选带明确编译器标识的项（如GCC 13.2.0或Visual Studio Enterprise 2022 - amd64） - 如果 kit 列表为空：Windows 用户检查是否装了
Build Tools for Visual Studio（比完整 VS 轻量，自带cl.exe）；Linux/macOS 用户确认已装build-essential（Ubuntu/Debian）或xcode-select --install（macOS）
configure 成功但 build 后 run 报错
构建成功只代表链接通过，不代表可执行文件能直接运行。常见于路径错、动态库没加载、或架构不匹配（比如在 Apple Silicon 上用 x86_64 编译器生成了错误二进制）。
立即学习“C++免费学习笔记（深入）”；
- 检查
launch.json里的program字段是否指向build/下刚生成的可执行文件（不是src/里的源码） - Linux/macOS 下若用了
find_package(OpenCV)等，运行前可能需要export LD_LIBRARY_PATH=/path/to/opencv/lib:$LD_LIBRARY_PATH；可在launch.json的env字段里写死 - macOS 上报
exec format error，八成是CMAKE_OSX_ARCHITECTURES设错了；在CMakeLists.txt里显式加set(CMAKE_OSX_ARCHITECTURES "arm64")（Apple Silicon）或"x86_64"（Intel）
c_cpp_properties.json 配的 includePath 总失效
VSCode 的 C/C++ 插件不读 CMake 实际路径，它只认自己那套 JSON 配置。手动写的 includePath 很容易和 find_package() 动态解析出的头文件位置对不上。
- 正确做法是让 CMake 生成标准的
compile_commands.json：在CMakeLists.txt里project()后加一行set(CMAKE_EXPORT_COMPILE_COMMANDS ON) - 运行一次
CMake: Build（或手动cmake --build build），确保build/compile_commands.json生成 - VSCode 设置中打开
C_Cpp > Configuration Provider，选ms-vscode.cmake-tools（不是 Default） - 再执行
C/C++: Reset IntelliSense Database，重启窗口更保险
Kit 和 toolchain file 容易混淆：Kit 是 CMake Tools 里的“本地编译器抽象”，toolchain file 是 CMake 原生的交叉编译机制（如编译 ARM Linux），两者不能互相替代。选对 Kit 只解决本地编译，交叉编译必须配 -DCMAKE_TOOLCHAIN_FILE=。
