Windows安装CMake后命令行找不到cmake命令，根本原因是安装时未勾选“Add CMake to the system PATH”选项，需手动将C:\Program Files\Cmake\bin加入系统环境变量Path并重启终端验证。
Windows 上装 CMake 不难，但容易卡在 PATH 没生效、生成器选错、或编译器没加载这三处。只要避开这几个坑，cmake --version 能跑通，后续构建基本不会断。
安装时必须勾选 Add CMake to system PATH
很多人装完 cmake --version 报“不是内部或外部命令”，根本原因就是安装时没勾选路径选项。MSI 安装包里有两个 PATH 选项：“for current user” 和 “for all users”，推荐选后者；如果漏选，手动加也行——路径通常是 C:\Program Files\CMake\bin，加进系统环境变量 Path 后，**必须重启终端（CMD/PowerShell）才能生效**，仅刷新窗口不行。
验证方式很简单：
- 新开一个 PowerShell，执行
cmake --version - 输出类似
cmake version 3.25.2即成功 - 如果提示找不到命令，别急着重装，先检查 PATH 是否拼写错误、是否多加了分号或空格
命令行构建必须用 VS 自带的 Native Tools 终端
直接用普通 CMD 或 PowerShell 运行 cmake .. -G "Visual Studio 17 2022" 很可能报错：找不到 cl.exe、找不到 Windows.h。这不是 CMake 的问题，而是 MSVC 编译器环境没加载。
正确做法是：开始菜单搜 x64 Native Tools Command Prompt for VS 2022（版本号按你装的 VS 对应），**用这个终端执行所有 cmake 命令**。它会自动注入 MSVC 工具链、Windows SDK 路径和相关环境变量。
常见误区：
- 以为装了 VS 就等于环境就绪 —— 实际上普通终端不继承这些变量
- 用 Git Bash 或 WSL 终端调用 Visual Studio 生成器 —— 会失败，因为底层依赖 Windows 原生工具链
- 混用不同架构终端（比如 x86 终端配 x64 生成器）—— 可能链接失败或生成无效项目
生成器参数 -G 必须匹配已安装的 VS 版本和架构
-G 参数不是随便填的。填错会导致 cmake 无法识别生成器，报错类似：CMake Error: Could not create named generator。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
查你本机支持哪些生成器：
cmake -G
输出列表里会有类似：
"Visual Studio 17 2022" = Generates Visual Studio 2022 project files"Visual Studio 17 2022 Win64" = Generates Visual Studio 2022 project files for x64"MinGW Makefiles" = Generates MinGW makefiles
关键点：
- VS 版本号要严格对应（如装的是 VS 2022，就不能写
Visual Studio 16 2019） - 若需 64 位构建，推荐显式加
-A x64，比依赖默认更可靠 - 如果用 MinGW，得提前把
gcc加进 PATH，并用-G "MinGW Makefiles"，不能混用 MSVC 生成器
构建目录必须独立于源码目录
CMake 强烈建议“out-of-source build”，也就是构建目录和源码目录分离。直接在源码根目录下运行 cmake . 看似省事，但会污染源码树，且后续切换配置（Debug/Release）或换编译器时极易出错。
标准流程是：
- 在项目根目录下新建
build文件夹 - 进入该文件夹：
cd build - 运行：
cmake .. -G "Visual Studio 17 2022" -A x64 - 再执行：
cmake --build . --config Release
注意：.. 是相对路径，指向 CMakeLists.txt 所在目录；--config 在 VS 生成器下必须指定，否则默认是 Debug；而 Ninja 或 Makefile 生成器则不用。
最容易被忽略的一点：如果你改过 CMakeLists.txt，又想重新生成构建系统，**不能只改完就 cmake --build，得先 cmake .. 再 build**——否则旧的构建规则还在，修改不会生效。
