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++ Code Review Master

组合式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**——否则旧的构建规则还在，修改不会生效。