CMake命令不识别是因为PATH未正确配置，需将CMake的bin目录（如C:\cmake\bin）添加到系统环境变量并重启终端；MinGW构建失败则需确保g++、make及对应generator路径均有效且无冲突。
cmake 命令不识别，PATH 没配对
直接运行 cmake --version 报“不是内部或外部命令”，说明系统根本找不到 cmake 可执行文件。这不是安装失败，而是 PATH 没生效。
- MSI 安装时必须勾选
Add CMake to the system PATH for all users（或当前用户），否则不会自动写入环境变量 - 手动解压 zip 版后，要添加的是
C:\path\to\cmake\bin，不是根目录；路径中不能有空格或中文（比如C:\Program Files\cmake\bin就容易出问题） - 改完 PATH 后，所有已打开的 cmd/PowerShell/VS Code 都得**重启**，否则看不到新配置
cmake .. -G "MinGW Makefiles" 报错 generator not found
你装了 MinGW-w64，也加了 g++ --version 能用，但 cmake .. -G "MinGW Makefiles" 仍失败，常见原因不是 generator 名字写错，而是 CMake 根本没检测到 MinGW 编译器。
- 确保
mingw32-make.exe或make.exe在 PATH 中（不是只有g++.exe）；MinGW-w64 官方构建版默认带mingw32-make.exe，但某些第三方打包版可能只提供make.exe -
-G "MinGW Makefiles"是旧式写法，CMake 3.20+ 更推荐用-G "Ninja"（需额外装 Ninja）或直接让 CMake Tools 自动选 kit - 如果用 VS Code + CMake Tools，别手敲
cmake -G，先按Ctrl+Shift+P→CMake: Select a kit，选中 MinGW（显示类似MinGW x86_64-11.2.0-posix-seh-rev1的条目）
build 目录里生成了 Makefile 却跑不起来 make
执行 cmake .. -G "MinGW Makefiles" 成功，build/ 下出现 Makefile，但 make 命令报错或找不到命令，本质是工具链链路断在最后一步。
- 确认终端是 **MinGW-w64 自带的 mingw64.exe 或 msys2.exe 启动的**，而不是原生 cmd —— 原生 cmd 不自带
make，即使 PATH 里有，也可能因 shell 环境差异导致路径解析失败 - 更稳妥的做法：进
build/后直接运行mingw32-make.exe（全名），而不是make；部分 MinGW 版本把可执行文件命名为mingw32-make.exe，且未创建make.exe符号链接 - 如果用 Ninja，需单独下载 ninja-win.zip，解压后把
ninja.exe放进 PATH，再用-G "Ninja"生成
CMakeLists.txt 写对了，但链接时报 undefined reference
编译通过，但链接阶段失败，提示类似 undefined reference to `std::cout' 或找不到 Win32 API 函数，说明 C++ 标准库或 Windows SDK 没被正确拉进来。
立即学习“C++免费学习笔记（深入）”；
-
set(CMAKE_CXX_STANDARD 17)必须放在project()之后、add_executable()之前，否则不生效 - MinGW-w64 默认用 posix 线程模型和 seh 异常处理，若项目依赖 MSVC 特有行为（如某些 COM 接口），得换
x86_64-win32-seh变体，而非posix-seh - 头文件路径用
include_directories(include)是旧写法，推荐改用target_include_directories(target_name PRIVATE include)，否则包含顺序和作用域容易混乱
bin 目录的优先级冲突、以及不同 MinGW 构建版本对 CMake generator 的兼容性差异——这些细节不报错，但会让整个流程静默失败。 
