c++怎么在Visual Studio中配置CMake项目_C++在VS中使用CMake构建跨平台工程-C++-PHP中文网

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

c++怎么在visual studio中配置cmake项目_c++在vs中使用cmake构建跨平台工程

在 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，并在其中创建以下文件结构：

MyCMakeProject/
├── CMakeLists.txt
└── src/
└── main.cpp

编辑 main.cpp：

#include <iostream>

int main() {
    std::cout <p>编辑根目录下的 <code>CMakeLists.txt</code>：</p>
<pre class="brush:php;toolbar:false;">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）。

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

git-push

自动用 git 提交代码并推送到远程仓库。当用户输入 `/gitpush` 时触发此技能。功能包括：自动暂存所有更改、自动生成提交信息、自动提交到本地仓库、自动推送到远程分支。成功后报告提交状态、文件数量和耗时。

下载

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 应用或跨平台项目。不复杂但容易忽略的是确保环境配置完整，尤其是远程开发场景下网络和权限设置。

C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！