c++oding="utf-8" ?>
cmake在windows上需匹配生成器与编译器：-g "visual studio 17 2022"要求vs2022及对应命令行环境，-g "mingw makefiles"需path含gcc/g++/make，-g "nmake makefiles"依赖vcvarsall.bat初始化；选错则报错，且不同config应分目录构建避免缓存污染。
cmake 在 Windows 上不是“装完就能用”的工具，它本身不编译代码，只生成构建文件。真正决定能否成功编译的，是你选的生成器（generator）是否匹配已安装的编译器，以及环境变量是否被正确加载。直接跑 cmake .. 十有八九报错，比如 Generator 'MinGW Makefiles' could not be found 或 Visual Studio 17 2022 was not found。
怎么选对 cmake -G 参数
Windows 下最常用的三类生成器对应三套工具链，不能混用：
-
-G "Visual Studio 17 2022"→ 必须已安装 Visual Studio 2022（或 Build Tools），且要用 x64 Native Tools Command Prompt 启动终端，普通 cmd 或 PowerShell 不行 -
-G "MinGW Makefiles"→ 要求系统 PATH 中能直接调用gcc、g++、make；注意：不是所有 MinGW 发行版都自带make，有些只带mingw32-make.exe，得手动 alias 或改名 -
-G "NMake Makefiles"→ 依赖 Visual Studio 的nmake.exe，必须先运行vcvarsall.bat（如"C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvars64.bat"）初始化环境
查可用生成器的最快方式：cmake -G（不加路径），输出列表里带 ✅ 的才是当前系统识别到的。
MinGW 编译失败常见原因
很多人卡在 make 报错，比如：
-
make: *** No targets specified and no makefile found→ 没生成 Makefile，确认cmake -G "MinGW Makefiles" ..是否执行成功，且CMakeLists.txt里写了add_executable等命令 -
gcc: error: unrecognized command-line option '-municode'→ CMakeLists.txt 里误加了 Windows GUI 特有 flag，MinGW 不支持；删掉set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -municode")这类行 -
undefined reference to `__imp__...→ 链接时缺库，常见于调用了 Windows API 但没加-luser32 -lgdi32；MinGW 默认不链接这些，得在target_link_libraries显式写
Visual Studio 生成器下 Release/Debug 混淆问题
用 cmake -G "Visual Studio 17 2022" .. 生成后，cmake --build . --config Release 和 --config Debug 是两个完全隔离的构建树。但很多人会：
- 先跑
cmake --build . --config Release，再跑cmake --build . --config Debug，结果 Debug 版本仍用 Release 的头文件或库路径 —— 因为 CMakeCache.txt 没清，缓存了上次的CMAKE_BUILD_TYPE - 在 VS IDE 里切换配置，但没点“重新生成”，导致旧 obj 文件残留，链接失败
稳妥做法：每个 config 单独建目录，比如 build-release/ 和 build-debug/，各自运行 cmake -S .. -B . -G "Visual Studio 17 2022" -A Win64，避免交叉污染。
CMakeLists.txt 里 target_compile_features 的坑
Windows 下用 MSVC 编译时，target_compile_features 容易触发奇怪错误，比如：
-
feature 'cxx_std_20' not known→ 不是 CMake 版本低，而是 MSVC 2022 默认不启用 C++20，得加set(CMAKE_CXX_STANDARD 20)和set(CMAKE_CXX_STANDARD_REQUIRED ON)才生效 -
feature 'cxx_concepts' not known→ MSVC 对 concepts 支持分阶段，2022 v17.5+ 才完整支持，旧版即使开了 /std:c++20 也会报这个错 - MinGW-w64 用 GCC 13+ 时，
cxx_constexpr可能被识别为cxx_constexpr_2017，写错名称就静默忽略
建议：不用 target_compile_features 做硬性检查，改用 if(MSVC) 或 if(CMAKE_CXX_COMPILER_ID STREQUAL "GNU") 分支控制编译选项更可靠。
真正的难点不在语法，而在每次换工具链都要重验一遍路径、环境变量、生成器兼容性——哪怕只是把 gcc 换成 clang-cl，cmake -G 参数和后续命令全得重来。
