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：

#include <iostream>  int main() {     std::cout << "Hello from CMake in Visual Studio! ";     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）。

你可以在“解决方案资源管理器”中看到源文件被正确解析。

Visual Studio IntelliCode

微软VS平台的 AI 辅助开发工具

27

查看详情

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}outbuild${name}",       "installRoot": "${projectDir}outinstall${name}",       "cmakeCommandArgs": "",       "buildCommandArgs": ""     },     {       "name": "WSL-Debug",       "generator": "Ninja",       "configurationType": "Debug",       "buildRoot": "${projectDir}/out/build/${name}",       "installRoot": "${projectDir}/out/install/${name}",       "wslPath": "\wsl$ubuntuhomeuserproject",       "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 应用或跨平台项目。不复杂但容易忽略的是确保环境配置完整，尤其是远程开发场景下网络和权限设置。