必须手动将CMake的bin目录(如C:\Program Files\CMake\bin)添加到系统PATH环境变量,并重启所有终端才能生效,否则cmake命令无法识别。

安装时没勾选“Add CMake to the system PATH”怎么办
命令行直接输 cmake --version 报错 'cmake' is not recognized as an internal or external command,基本就是 PATH 没配好。这不是重装就能解决的问题,必须手动补上。
- 找到 CMake 安装目录下的
bin子目录,典型路径如:C:\Program Files\CMake\bin或C:\Program Files (x86)\CMake\bin - 右键“此电脑” → “属性” → “高级系统设置” → “环境变量”,在“系统变量”或“用户变量”中编辑
Path - 新增一行,粘贴上面的
bin路径(不要带引号,结尾不加反斜杠) - 关键动作:所有已打开的终端(CMD、PowerShell、VS Code 终端)必须全部关闭再重开,否则 PATH 不生效
用 winget 或 Chocolatey 安装后仍找不到 cmake
winget install Kitware.CMake 或 choco install cmake -y 看似一键完成,但实际可能失败——尤其是权限不足或策略拦截时,cmake --version 依然报错。
组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。
- winget 默认以当前用户身份安装,但 PATH 更新有时延迟,建议重启终端后运行
where cmake查看是否真有可执行文件 - Chocolatey 安装时若没加
--installargs 'ADD_CMAKE_TO_PATH=System',它默认不改 PATH;只用choco install cmake -y是不够的 - 如果
where cmake返回空,说明二进制根本没落盘,得检查 Chocolatey 是否被组策略禁用,或尝试管理员权限重装
解压版 CMake(ZIP)怎么避免路径出错
下载 cmake-3.28.3-windows-x86_64.zip 解压后直接用,省事但路径一写错就失效。常见坑不是版本问题,而是路径本身含空格或中文。
- 解压目标路径禁止含中文、空格、括号,例如
C:\tools\cmake安全,C:\My Tools\CMake或D:\开发工具\cmake都会触发后续构建失败 - PATH 中添加的是
C:\tools\cmake\bin,不是C:\tools\cmake——少一个\bin就找不到cmake.exe - 验证方式不是只看
cmake --version,还要运行cmake -G "MinGW Makefiles" .或cmake -G "Visual Studio 17 2022" -A x64 .,确认生成器能识别编译器
VS Code 中 CMake Tools 找不到 cmake
装了插件却提示 “CMake executable not found”,不是插件问题,而是 VS Code 终端和图形界面加载的环境变量不一致。
- CMake Tools 插件读取的是 VS Code 启动时加载的 PATH,不是你后来在终端里手动 setx 设置的
- 解决方案:完全退出 VS Code(包括后台进程),再从开始菜单或桌面快捷方式重新启动,确保它继承最新系统 PATH
- 如果仍不行,在 VS Code 设置里搜
cmake.cmakePath,手动设为绝对路径,例如:C:\Program Files\CMake\bin\cmake.exe - 注意:该设置值必须是可执行文件路径,不能是目录;且路径中的反斜杠要双写或改用正斜杠,避免转义错误
where cmake 和 $env:Path -split ';' | Select-String cmake(PowerShell)交叉验证,比反复重装高效得多。

















