C++如何利用CMake生成Visual Studio工程文件

浅强大大_8933

浅强大大_8933

2026-07-14

1030人浏览

原创

正确写法是:在新建构建目录中执行cmake -g "visual studio 17 2022" -a x64 ..(需指定生成器-g和架构-a),否则默认不生成.sln;cmakelists.txt必须含project()、add_executable()等必要指令,且源文件路径须真实存在。

c++如何利用cmake生成visual studio工程文件

cmake命令行生成VS工程的正确写法

直接用 cmake 命令就能生成 Visual Studio 的 .sln 和 .vcxproj 文件,但必须指定生成器(generator),否则默认生成 Unix Makefiles 或 Ninja,根本不会输出 VS 工程。

常见错误是只运行 cmake .,结果发现目录里只有 CMakeFiles 和 Makefile,完全没出现 .sln —— 这是因为没告诉 CMake 你要 VS。

  • 查可用生成器:运行 cmake -G(不带参数),会列出所有支持的 generator,Windows 上典型的是 "Visual Studio 17 2022"、"Visual Studio 16 2019"
  • 生成 64 位工程(推荐):cmake -G "Visual Studio 17 2022" -A x64 ..(注意 -A x64 指定架构,不加可能默认 Win32)
  • 生成 32 位工程:cmake -G "Visual Studio 17 2022" -A Win32 ..
  • 务必在新建的构建目录中执行(如 mkdir build && cd build),不要在源码根目录直接 cmake .,否则会污染源码树

CMakeLists.txt里必须写的最低配置

VS 工程能生成出来,不代表能编译通过。CMakeLists.txt 至少要声明项目名、语言标准和可执行文件/库,否则 VS 打开后会报错“no target”或“no source files”。

一个最小但可工作的例子:

C++ Code Review Master
C++ Code Review Master

组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载
cmake_minimum_required(VERSION 3.10)
project(MyApp LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

add_executable(MyApp main.cpp)
  • project() 必须有,且 LANGUAGES CXX 显式声明 C++,否则 VS 可能识别为 C 项目,导致 std::string 等类型报错
  • add_executable() 的第二个参数必须是真实存在的源文件路径(相对 CMakeLists.txt),VS 不会自动扫描 *.cpp,漏写就生成空项目
  • 如果用了第三方头文件(比如 #include <fmt></fmt>),仅靠 add_executable 不够,必须用 find_package(fmt REQUIRED) + target_link_libraries(MyApp fmt::fmt),否则 VS 加载后编译直接失败

生成后在VS里打不开或提示平台工具集不匹配

生成的 .sln 打不开,或者打开后显示“Unsupported”、“The build tools for v143 cannot be found”,本质是 CMake 生成时绑定的平台工具集(toolset)和本机安装的 Visual Studio 组件不一致。

  • 检查本机已安装的工具集:打开 VS Installer → 修改当前 VS → “单独组件”里搜 “MSVC v143”(对应 VS 2022)、“v142”(VS 2019)
  • 强制指定工具集生成:cmake -G "Visual Studio 17 2022" -T v143 -A x64 ..(-T 参数必须紧接 -G 后,顺序不能错)
  • 如果机器只装了 Community 版,但 CMake 默认找 Enterprise 的 SDK 路径,可能报错 WindowsSdkNotFound;此时加 -DCMAKE_SYSTEM_VERSION="10.0.19041.0" 显式指定 SDK 版本(查注册表 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SDKs\Windows 可确认)
  • VS 版本升级后(比如从 17.5 升到 17.8),旧生成的 .sln 可能无法加载,必须重新运行 cmake,不能复用

为什么生成的工程里没有资源文件或自定义生成步骤

CMake 默认只处理源码和链接逻辑,VS 里的资源(.rc)、自定义生成工具(.idl、.def)、预编译头(stdafx.h)等,必须显式声明,否则它们在 .vcxproj 中完全不可见。

  • 添加资源文件:source_group("Resource Files" FILES myapp.rc) + target_sources(MyApp PRIVATE myapp.rc)
  • 启用预编译头:set_target_properties(MyApp PROPERTIES VS_WINRT_COMPONENT TRUE) 不对——正确做法是 target_precompile_headers(MyApp PRIVATE "stdafx.h")(CMake 3.16+)
  • 自定义生成(如 .idl 编译):需用 add_custom_command() 和 add_custom_target() 配合 target_sources() 注入输出文件,否则 VS 不知道该调用 midl.exe
  • VS 的“属性页”配置(如 /MP 并行编译、/bigobj)不能靠 GUI 手动设,应统一用 target_compile_options(MyApp PRIVATE /MP) 或 set_property(TARGET MyApp PROPERTY MSVC_RUNTIME_LIBRARY "MultiThreadedDLL")

生成 VS 工程不是终点,而是把 CMake 的抽象逻辑落地成 VS 能理解的项目结构;漏掉任何一项显式声明,都会导致 VS 表现异常——它不会猜你要什么,只会严格按 CMake 输出的内容加载。

C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

cmake c++ visual studio

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
c++和c语言的区别有哪些
c++和c语言的区别有哪些

c++和c语言的区别:1、面向对象编程(OOP)支持不同;2、新增特性不同;3、标准库不同;4、编译方式不同;5、命名空间不同等等。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.14

2208

9

c++和python学习顺序推荐
c++和python学习顺序推荐

一般建议先学习C++,再学习Python,因为这样可以逐步从较为底层的编程语言向更高级的语言过渡。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

979

6

python和c++学习性价比分析
python和c++学习性价比分析

Python易于学习,广泛应用于Web开发、数据科学和人工智能等领域,但性能较低。C语言性能高,适用于对性能要求较高的场景,如游戏开发和系统编程,但学习曲线陡峭,错误处理复杂。想了解更多python的相关内容,可以阅读本专题下面的文章。

2024.03.14

407

5

c语言和c++一样吗
c语言和c++一样吗

c语言和c++是两种不同的编程语言,虽然有相似之处,但存在显著差异。c语言专注于过程式编程和系统级开发,以简洁、高效著称。c++作为c语言的超集,引入了面向对象编程,增强了代码组织和管理能力,但学习曲线也更陡峭。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

307

5

c语言和c++先学哪个好
c语言和c++先学哪个好

初学者选择学习c语言还是c++语言,需要根据个人学习目标、背景以及编程兴趣和预期应用方向来决定。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

386

5

c语言和c++的区别和联系
c语言和c++的区别和联系

c语言和c++是计算机科学领域应用广泛的编程语言。虽然它们有着相似的基础,但它们在语言类型、语法功能和内存管理方面存在着显著差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.03.14

580

5

c++软件中文更改教程
c++软件中文更改教程

对于 ide,可通过打开设置,找到语言设置,选择中文,并保存更改。对于非 ide 应用程序,可查找设置或选项,选择语言设置,更改为中文,并保存更改。想了解更多c++的相关内容,可以阅读本专题下面的文章。

2024.03.21

1389

9

python和java和c++学习性价比分析
python和java和c++学习性价比分析

Python以其易学性、丰富的库和活跃的社区而著称,适合数据科学、人工智能和Web开发。Java以其跨平台性、企业级应用开发和Android应用开发而闻名。C++以其底层控制能力、高效性能和游戏开发而著称。选择哪种语言取决于个人兴趣、职业方向和特定需求。想了解更多python和java和c++的相关内容,可以阅读本专题下面的文章。

2024.03.22

1197

7

c++和c语言学习顺序推荐
c++和c语言学习顺序推荐

对于初学者,建议先学习C语言,掌握编程基础后再转入C++,便于理解面向对象编程概念。有编程经验者可直接学习C++,快速接触高级编程技术。想了解更多c++和c语言的相关内容,可以阅读本专题下面的文章。

2024.03.25

1325

9

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习

Conan 2 入门教程
Conan 2 入门教程

共0课时 | 0人学习

CLion CMake 快速入门教程
CLion CMake 快速入门教程

共0课时 | 0人学习