cmake 在 windows 命令行默认不检测 visual studio 实际安装状态，需显式指定完全匹配的生成器名称（如 "visual studio 17 2022"），推荐用 cmake --help 查可用列表、vswhere 验证 vs 安装，并通过 cmakepresets.json 统一管理配置。
Windows 上 CMake 默认会选 Visual Studio 16 2019 或更高版本（取决于已安装的 VS），但这个选择不检查本地是否真有对应工具链——没装却硬用，cmake .. 直接报错：CMake Error: Could not create named generator。必须显式指定可用生成器。
怎么查当前系统有哪些可用生成器
运行 cmake --help（不是 cmake -h），输出末尾会列出所有支持的 generator 列表，带平台标识，比如：
Generators Visual Studio 17 2022 = Generates Visual Studio 2022 project files. Visual Studio 16 2019 = Generates Visual Studio 2019 project files. Ninja = Generates build.ninja files. MinGW Makefiles = Generates Makefiles for MinGW make.
注意：列表里出现 ≠ 你本地能用。比如显示 Visual Studio 17 2022，但你只装了 VS 2019，那它就不可用；反之，装了 VS 2022 却没装 C++ 工作负载，也会失败。
- 推荐先用
vswhere -version [17.0,18.0)查 VS 安装路径和组件状态（需提前安装vswhere） -
Ninja是最轻量、最稳定的替代选项，只要装了ninja.exe并在PATH中，基本不会出兼容问题
命令行指定生成器的正确写法
必须用 -G 参数，且 generator 名称要**完全匹配**（大小写敏感、空格不能少），例如：
cmake -G "Visual Studio 17 2022" -A x64 ..
常见错误写法：
-
cmake -G "VS2022"→ 不识别，generator 名不是缩写 -
cmake -G "Visual Studio 17"→ 缺少年份，不合法 -
cmake -G Ninja ..→ 少引号，Windows cmd 下会解析失败（PowerShell 可能侥幸成功，但不推荐）
如果目标是 64 位构建，加 -A x64（对 VS generator）；Ninja 不需要 -A，它由 CMAKE_GENERATOR_TOOLSET 或环境决定架构。
用 CMakePresets.json 避免每次敲长命令
VS 2019+ 和 CMake 3.20+ 支持 CMakePresets.json，比 CMakeSettings.json 更通用、更可移植。一个最小可用配置：
{
"version": 6,
"configurePresets": [
{
"name": "win-vs2022-x64",
"displayName": "Visual Studio 2022 (x64)",
"description": "Using VS 2022 with x64 toolset",
"generator": "Visual Studio 17 2022",
"binaryDir": "${sourceDir}/build/win-vs2022",
"cacheVariables": {
"CMAKE_BUILD_TYPE": "RelWithDebInfo"
}
}
]
}
之后只需 cmake --preset win-vs2022-x64，不用记参数顺序或引号规则。注意：version 字段必须匹配你当前 CMake 版本支持的 schema（VS 2022 对应 version 3~6，CMake 3.25+ 推荐用 6）。
为什么 cmake-gui 和 VS IDE 有时“自动选对”而命令行失败
GUI 和 VS 插件会主动扫描注册表或调用 vswhere 查找已安装的 VS 实例，并从中挑一个可用的 generator；命令行 cmake 默认只按名称硬匹配，不做探测。所以：
- 如果你只装了 VS 2022 但没装 C++ 桌面开发工作负载，GUI 可能 fallback 到 Ninja，而命令行仍报错 generator not found
- VS 的 CMake 集成默认使用
CMakeSettings.json，它内部会把generator映射为实际路径，但该文件不被纯命令行读取 - 环境变量
VSCMD_VER或VSINSTALLDIR不影响cmake -G行为，仅影响 VS 自带的开发者命令提示符中的默认行为
真正可靠的方案只有两个：要么用 cmake --preset + CMakePresets.json 统一管理，要么每次用 cmake --help 确认后再敲完整 -G 参数——别信“应该能用”的猜测。
