Visual Studio原生支持CMake项目开发,无需.vcxproj文件。安装“使用C++的桌面开发”工作负载后,创建含CMakeLists.txt和源码的项目文件夹,通过“打开文件夹”功能加载,VS自动解析并构建。配置CMakeSettings.json可实现WSL或远程Linux跨平台编译,结合vcpkg可管理第三方库,支持Windows、Linux统一开发流程。

在 Visual Studio 中使用 CMake 构建 C++ 跨平台项目,无需依赖传统的 .vcxproj 工程文件。Visual Studio 自 2017 版本起原生支持 CMake,可以直接打开包含 CMakeLists.txt 的文件夹并进行构建和调试。以下是详细配置步骤。
1. 准备工作:安装必要的组件
确保你的 Visual Studio 安装包含了以下组件:
- C++ CMake 工具(用于在 VS 中解析和构建 CMake 项目)
- 适用于 Windows 的桌面开发(包含 MSVC 编译器)
- 可选:Git(用于拉取示例代码或第三方库)
打开 Visual Studio Installer,检查是否已安装“使用 C++ 的桌面开发”工作负载,并确认其中包含“C++ CMake 工具”。
2. 创建基于 CMake 的项目结构
新建一个项目文件夹,例如 MyCMakeProject,并在其中创建以下文件结构:
立即学习“C++免费学习笔记(深入)”;
MyCMakeProject/├── CMakeLists.txt
└── src/
└── main.cpp
编辑 main.cpp:
#includeint main() { std::cout << "Hello from CMake in Visual Studio!\n"; return 0; }
编辑根目录下的 CMakeLists.txt:
cmake_minimum_required(VERSION 3.15) project(MyCMakeProject) set(CMAKE_CXX_STANDARD 17) add_executable(MyCMakeProject src/main.cpp)
3. 在 Visual Studio 中打开 CMake 项目
启动 Visual Studio,选择“继续但无需代码”,然后点击菜单栏的:
文件 → 打开 → 文件夹,选择你创建的 MyCMakeProject 文件夹。
Visual Studio 会自动检测到 CMakeLists.txt 并加载 CMake 项目。首次打开时,VS 会在后台运行 CMake 生成构建系统(默认使用 Ninja 或 MSVC 的 nmake)。
你可以在“解决方案资源管理器”中看到源文件被正确解析。
4. 构建与调试
构建项目:
- 右键点击
CMakeLists.txt或源文件 → “设为启动项” - 按 F5 启动调试,或点击工具栏的“全部构建”
也可以通过“CMake”菜单执行:
- CMake → 构建所有
- CMake → 调试 → 启动而不调试
输出结果将在“输出”窗口中显示。
5. 支持跨平台开发(Linux/WSL)
若想在 Linux 或 WSL 上构建,可在 Visual Studio 中配置远程连接:
- 转到“工具 → 选项 → 跨平台 → 连接管理器”
- 添加 WSL 或远程 Linux 主机
- 在项目根目录添加
CMakeSettings.json配置文件,指定使用 WSL 环境
示例 CMakeSettings.json(自动生成也可手动编辑):
{
"configurations": [
{
"name": "x64-Debug",
"generator": "Ninja",
"configurationType": "Debug",
"buildRoot": "${projectDir}\\out\\build\\${name}",
"installRoot": "${projectDir}\\out\\install\\${name}",
"cmakeCommandArgs": "",
"buildCommandArgs": ""
},
{
"name": "WSL-Debug",
"generator": "Ninja",
"configurationType": "Debug",
"buildRoot": "${projectDir}/out/build/${name}",
"installRoot": "${projectDir}/out/install/${name}",
"wslPath": "\\\\wsl$\\Ubuntu\\home\\user\\project",
"remoteMachineName": "WSL",
"cmakeExecutable": "/usr/bin/cmake",
"cmakeCommandArgs": "-DCMAKE_BUILD_TYPE=Debug"
}
]
}
切换配置后,CMake 会在 WSL 环境中运行,实现跨平台构建。
6. 添加第三方库(如使用 vcpkg)
vcpkg 是微软提供的 C++ 包管理器,与 Visual Studio 和 CMake 深度集成。
- 安装 vcpkg:
git clone https://github.com/Microsoft/vcpkg - 集成到 VS:
vcpkg integrate install - 在
CMakeLists.txt中使用:
find_package(fmt REQUIRED) target_link_libraries(MyCMakeProject PRIVATE fmt::fmt)
Visual Studio 会自动处理头文件路径和链接库。
基本上就这些。Visual Studio 对 CMake 的支持已经非常成熟,适合开发本地 Windows 应用或跨平台项目。不复杂但容易忽略的是确保环境配置完整,尤其是远程开发场景下网络和权限设置。











