VSCode本身不提供CMake或编译器，CMake Tools仅是调度器；配置失败主因是本地工具链未就位或环境变量未继承，需确保cmake和编译器（g++/cl.exe/clang++）已安装并正确配置PATH，修改后必须重启VSCode，并通过CMake: Select a Kit准确选择匹配架构的Kit。
VSCode 本身不提供 CMake 或编译器，CMake Tools 插件只是调度器；配置失败绝大多数情况是本地工具链没就位，而不是插件或 VSCode 的问题。
找不到 cmake 命令或提示 “CMake not found”
VSCode 终端能运行 cmake --version，但插件报错，说明它没继承 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++」工作负载；若只装 Build Tools，也要确保它包含
cl.exe - VSCode 里按
Ctrl+Shift+P→ 输入CMake: Select a Kit，选带明确编译器标识的项（如GCC 13.2.0或Visual Studio Enterprise 2022 - amd64） - 如果 kit 列表为空：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，大概率是编译器架构与当前 CPU 不匹配，检查 kit 是否选对（如 Apple Silicon 应选Clang for arm64而非x86_64）
c_cpp_properties.json 里 includePath 配了却还报找不到头文件
C/C++ 插件不读 CMake 的实际构建配置，它只认自己那套 c_cpp_properties.json。你手动写的 includePath 很可能和 CMake 实际生成的路径不一致，尤其在使用 find_package() 时。
- 在
CMakeLists.txt中启用set(CMAKE_EXPORT_COMPILE_COMMANDS ON)（推荐放在project()后面） - 运行一次
cmake --build build或用 CMake Tools 点击 “Build”，生成build/compile_commands.json - 在 VSCode 设置中打开
C_Cpp > Configuration Provider，选ms-vscode.cmake-tools - 重启窗口或执行命令面板中的
C/C++: Reset IntelliSense Database
真正容易被忽略的是：CMake Tools 插件不会自动重载环境变量，也不会自动感知新装的编译器；每次换工具链、改 PATH、或加新库，都要重启 VSCode 并重新 CMake: Configure —— 这一步跳过，后面所有操作都可能失效。
