CMake安装后命令行找不到cmake命令，本质是cmake.exe未加入系统PATH环境变量；需手动将C:\Program Files\CMake\bin等路径添加至PATH，并彻底重启VS Code才能生效。
cmake --version 报错或找不到命令
这是最常见卡点：CMake 安装了 GUI，但 cmake.exe 没进系统 PATH。VS Code 的 CMake Tools 插件依赖命令行版 cmake，不是 cmake-gui.exe。
- 确认你安装的是 Binary distributions（.msi 或 .zip），不是 Source distributions
- 手动检查
cmake.exe路径，常见位置：C:\Program Files\CMake\bin\cmake.exe或解压后的cmake-4.x.x-windows-x86_64\bin\cmake.exe - 把该
bin目录加进 Windows 系统环境变量PATH，**必须重启 VS Code 才生效**（只重载窗口不够） - 在 VS Code 终端里运行
where cmake，应返回具体路径；若无输出，说明 PATH 未生效
CMake: Select a Kit 选不到 MinGW 或 MSVC
VS Code 不会自动发现编译器，它靠扫描 PATH 或注册表找 “kit” —— 实际就是编译器可执行文件的路径和元信息。
- 确保 MinGW 的
bin（含g++.exe、gcc.exe）已加入PATH；或 MSVC 的cl.exe可被找到（通常随 Visual Studio 安装，需勾选 “Desktop development with C++”） - 按
Ctrl+Shift+P→ 输入CMake: Scan for Kits，等几秒，再试CMake: Select a Kit - 如果仍没列出，可手动编辑
.vscode/c_cpp_properties.json，但更推荐先验证g++ --version或cl能否在 VS Code 终端中直接运行 - MinGW 建议选
x86_64-14.2.0-release-posix-seh-rt_v12-rev0这类带seh和ucrt的版本，兼容性更好；MSVC 则优先选Visual Studio 17 2022对应的 kit
CMakeLists.txt 配置后 build 失败：找不到源文件或链接错误
VS Code 的 CMake Tools 默认在项目根目录下建 build/ 子目录执行 out-of-source 构建，但 CMakeLists.txt 里的路径是相对于它自己的位置，不是 build 目录。
-
add_executable中的源文件路径必须是相对于CMakeLists.txt所在目录的，比如main.cpp在同级，就写main.cpp；若在src/下，就得写src/main.cpp - 不要用绝对路径，也别写
./src/main.cpp—— CMake 会自动处理相对路径 - 如果用了第三方库（如 OpenCV），
find_package(OpenCV REQUIRED)必须在add_executable之前，且target_link_libraries要明确指定目标名，例如：target_link_libraries(HelloWorld ${OpenCV_LIBS}) - Windows 下链接失败常因 ABI 不匹配：MinGW 编译的 OpenCV 必须用 MinGW 编译你的项目，不能混用 MSVC 版本
Build 按钮灰掉或 Configure 一直转圈
这通常不是配置问题，而是 CMake Tools 插件状态异常或缓存残留。
- 先关掉所有 VS Code 窗口，删掉项目根目录下的
build/和.vscode/（保留CMakeLists.txt和源码），再重新打开文件夹 - 检查左下角状态栏是否显示 “Ready” 和当前 kit 名；若显示 “No kits found”，说明前面的 kit 扫描失败
- 不要手动在终端里 cd 到 build 目录执行
cmake .. && make—— CMake Tools 有自己的构建流程，混用容易冲突 - 如果项目含中文路径或空格，CMake 有时会解析失败，临时改用纯英文无空格路径测试
CMake 在 Windows 上真正难的不是语法，而是工具链的“对齐”：MinGW/MSVC/CMake/VS Code 四者版本、ABI、PATH、kit 识别，只要其中一环断开，就会卡在看似无关的报错里。最容易被忽略的是：每次改完环境变量，必须彻底关闭并重启 VS Code —— 它不会热更新 PATH。
