答案是PATH未正确配置，因安装时未勾选“Add CMake to the system PATH”或注册失效；需手动将CMake的bin目录（如C:\Program Files\Cmake\bin）添加到系统环境变量PATH中，并重启终端验证cmake --version。
cmake --version 不生效，PATH 没加对
安装时没勾选“Add CMake to the system PATH”是常见原因。即使安装程序声称自动添加，Windows 有时会只加给当前用户、或漏掉系统级 PATH。
验证方式：打开新 cmd（不是已打开的旧窗口），运行 cmake --version。如果报错“不是内部或外部命令”，说明 PATH 没生效。
- 手动添加：找到 CMake 安装目录下的
bin子目录（例如C:\Program Files\CMake\bin或C:\Users\XXX\AppData\Local\Programs\CMake\bin） - 右键“此电脑” → “属性” → “高级系统设置” → “环境变量”，在“系统变量”中找到
Path，点击“编辑” → “新建”，粘贴上面的bin路径 - 重启所有 cmd / PowerShell / VS Code 窗口，再试
cmake --version
用 cmake 命令生成 MinGW Makefile，但报错找不到编译器
cmake 默认尝试调用 Visual Studio 工具链，而你装的是 MinGW-w64。不指定生成器，它不会自动识别 gcc。
必须显式指定生成器，并确保 gcc --version 在 cmd 中能正常返回版本号（即 MinGW 的 bin 也已加入 PATH）。
- 进入项目根目录（含
CMakeLists.txt），创建空build子目录 - cd 进入
build目录，运行：cmake -G "MinGW Makefiles" .. - 如果仍失败，加
-DCMAKE_C_COMPILER=gcc -DCMAKE_CXX_COMPILER=g++显式指定编译器路径 - 生成成功后，运行
mingw32-make（不是make）编译
CMakeLists.txt 写好了，但 configure 阶段提示 project() 版本太低或语法错误
Windows 上的 CMake 版本可能比你写的 cmake_minimum_required(VERSION X.X) 低，或者用了不兼容的语法（比如新版才支持的 find_package(... CONFIG)）。
尤其注意：MSI 安装包默认可能装的是较旧稳定版（如 3.22），而某些教程示例要求 3.25+。
- 先运行
cmake --version确认实际版本 - 把
cmake_minimum_required改成低于或等于你本地版本（例如本地是 3.22.1，就写VERSION 3.22） - 避免使用
target_link_libraries(target PRIVATE ...)里的PRIVATE关键字——老版本只认target_link_libraries(target ...) - 如果用
find_package(OpenCV REQUIRED)，确保 OpenCV 的OpenCVConfig.cmake在CMAKE_PREFIX_PATH范围内，否则会报“Could not find a package configuration file”
VS Code 里 CMake Tools 插件找不到 cmake 或编译器
插件依赖系统 PATH，但它启动时读取的是 VS Code 启动那一刻的环境变量。如果你后来改了 PATH，没重启 VS Code，插件就看不到新配置。
另外，CMake Tools 默认不自动探测 MinGW，需要手动选择工具链。
- 关闭所有 VS Code 实例，重新从开始菜单或桌面快捷方式启动（确保加载最新 PATH）
- 按
Ctrl+Shift+P→ 输入CMake: Select a Kit→ 选择带 “GCC” 和路径标识的 kit（如GCC for x86_64-w64-mingw32 13.2.0） - 如果 kit 列表为空，点击 “Scan for kits”，它会搜索 PATH 下的
gcc.exe和cmake.exe - 确认状态栏右下角显示 kit 名称和构建类型（如
MinGW Makefiles），再点 “CMake: Configure”
cmake --version、gcc --version、cmake -G "MinGW Makefiles" .. 这三步在纯 cmd 里都通了，后续流程就很少卡住。 
