CMake需用-G指定标准生成器名如"Visual Studio 17 2022",不可简写为"VS2022";架构须显式加-A x64等参数;工具集需配合-T且确保已安装;更换生成器前应清空构建目录以防缓存冲突。

用 -G 参数指定 Visual Studio 生成器版本
CMake 本身不“识别” VS 年份,而是通过内置的 -G(generator)参数匹配对应版本的官方生成器名称。你得写对名字,否则 CMake 会报错或退化成默认 Ninja/Makefile。
-
cmake -G "Visual Studio 17 2022"→ VS 2022(注意空格和年份顺序) -
cmake -G "Visual Studio 16 2019"→ VS 2019 -
cmake -G "Visual Studio 15 2017"→ VS 2017 -
cmake -G "Visual Studio 14 2015"→ VS 2015(仅支持到 CMake 3.19)
别写成 "VS2022" 或 "Visual Studio 2022"——CMake 不认。运行 cmake -G(不带值)可列出本机所有可用生成器,确认你装的 VS 版本是否被识别。
平台架构(x64 / Win32 / ARM64)必须显式指定
VS 生成器默认生成 Win32(即 x86)平台,但多数现代项目需要 x64。漏掉平台参数会导致生成的 .sln 打开后编译失败,或配置里平台名显示为 Win32 却实际跑在 x64 环境下。
- 加
-A x64:生成 x64 平台工程(推荐,兼容性好) - 加
-A Win32:强制 x86(少见,除非真要兼容老旧设备) - 加
-A ARM64:对应 VS 2019+ 的 ARM64 支持
示例完整命令:cmake -G "Visual Studio 17 2022" -A x64 ..。注意 -A 必须跟在 -G 后面,顺序不能反,否则 CMake 会忽略。
Visual Studio 18.8.1 官方固定版本安装引导程序,当前条目使用微软发布历史中的 Professional Web Installer,适合旧项目兼容、环境回退、复现特定构建链和排查版本差异等场景。
生成器名称隐含工具链版本,不能靠 CMAKE_GENERATOR_TOOLSET 覆盖
比如你装了 VS 2022,但想用 v142 工具集(VS 2019 的),不能只写 -G "Visual Studio 17 2022" 再配 -T v142 就完事——它会报错或静默失败。正确方式是:
- 先确认 VS 安装时是否勾选了对应旧版工具集(如 v142、v143)
- 用
-T显式指定:cmake -G "Visual Studio 17 2022" -A x64 -T v143 .. - v143 是 VS 2022 默认,v142 是 VS 2019,默认不共存,强行指定需确保已安装
错误现象:CMake Error: Could not create named generator 或生成后打开 sln 报“找不到工具集”。这时候不是 CMake 版本低,而是工具集没装全。
生成路径和缓存残留容易导致 sln 更新失败
CMake 不会自动覆盖已有 .sln 文件里的项目引用或平台配置。如果你改了 -G 或 -A 重新运行,但没清掉旧构建目录,CMake 可能复用旧缓存,导致生成的 sln 仍是旧平台、旧 VS 版本。
- 安全做法:每次换生成器前,删掉整个构建目录(
rm -rf build/或手动清空) - 或者用全新目录:
mkdir build-vs2022 && cd build-vs2022 && cmake -G "Visual Studio 17 2022" -A x64 .. - 别依赖
cmake --build . --clean-first——它只清编译产物,不重生成 sln
最常被忽略的一点:VS 打开 sln 后,如果之前用过不同平台(比如 Win32),即使你新生成的是 x64,Solution Explorer 里仍可能默认显示 Win32 配置,需要手动在顶部工具栏切换 Active Solution Platform 到 x64。

















