前言与基本概念#

近日在做本科毕设的实验环境搭建，涉及到了基于 vcpkg 进行 C++ 库管理的开发工作。由于程序以 FLTK 为 GUI 框架且遵循 MVVM 架构，需要使用 CMake 进行项目配置。笔者在手持 Mac 与 Windows 双设备的同时，被要求进行 Windows/Linux 双平台的软件开发，为此经过资料收集与实践，最终总结出在 Windows/Linux/Mac 三平台下，如何在 VSCode 中配置 CMake 并使用 vcpkg 的方法，能做到不同平台下的开发体验一致。

我们的目标是在不同的平台上用近乎相同的方式进行 vcpkg + CMake 项目的配置。在微软官方的 vcpkg 文档中，已经介绍了 vcpkg 的相关概念。简要来说，vcpkg 是微软推出的基于 C++ 语言的跨平台包管理工具，可以看作是 C++ 领域的 npm 或 pip。

CMake 是适用于 C/C++ 项目的跨平台构建系统，通过 CMakeLists.txt 文件来定义项目的构建过程。vcpkg 与 CMake 的结合使用，可以简化 C++ 项目的依赖管理和构建配置。

这种项目的一般配置与构建流程是：

1. 配置好 CMake 与 vcpkg 环境；
2. 在项目的 CMakeLists.txt 文件中指定 vcpkg 的工具链文件；
3. 安装 vcpkg 所涉及的依赖库；
4. 使用 CMake 生成构建文件并编译项目。

上述工具都是跨平台的，至于代码编辑器，我们使用同样跨平台的 Microsoft Visual Studio Code (VSCode)，并安装相关插件以支持 CMake 和 C++ 开发。

环境配置#

注意

下文中，默认读者掌握基本的命令行操作和 Git 使用方法。同时，Windows 平台下，使用 Powershell 作为命令行工具。

1
sudo apt-get update
2
sudo apt-get install cmake

1
brew install cmake

1
git clone https://github.com/microsoft/vcpkg.git

1
cd vcpkg; .\bootstrap-vcpkg.bat

1
cd vcpkg && ./bootstrap-vcpkg.sh

1
export VCPKG_ROOT=/path/to/vcpkg
2
export PATH=$VCPKG_ROOT:$PATH

项目配置#

这里以一个 FLTK 界面程序为例，参见仓库中的 Hello 项目。打开项目目录，可以看到：

1
.
2
├── CMakeLists.txt
3
├── code
4
│   ├── CMakeLists.txt
5
│   └── main.cpp
6
├── vcpkg-configuration.json
7
└── vcpkg.json
8

9
2 directories, 5 files

这里 code 文件夹中的 CMakeLists 已经配置好，我们关心根目录下的 CMakeLists.txt 文件：

1
cmake_minimum_required(VERSION 3.10)
2

3
project(Hello)
4

5
find_package(FLTK CONFIG REQUIRED)
6

7
add_subdirectory(code code)

注意

第三句的 fltk 需要改为大写 FLTK，具体原因将在后面解释。

这里的第三句 find_package(FLTK CONFIG REQUIRED) 指定了需要使用 FLTK 库，并且要求 CMake 使用配置模式（CONFIG）来查找该库。配置模式意味着 CMake 会寻找由 vcpkg 提供的配置文件，这些文件通常位于 vcpkg 的安装目录中。

再查看 vcpkg.json 文件：

1
{
2
  "dependencies": [
3
    "fltk"
4
  ]
5
}

这里指定了项目所需的依赖库为 FLTK，vcpkg 会根据这个文件来安装和管理项目的依赖。所以我们应该先 vcpkg install 来进行 FLTK 库的安装，然后再使用 CMake 进行项目的配置和构建。

但是总是这样做未免繁琐，我们在 VSCode 中使用 CMake 插件来简化流程。

1
{
2
  "cmake.configureSettings": {
3
    "CMAKE_TOOLCHAIN_FILE": "/path/to/vcpkg/scripts/buildsystems/vcpkg.cmake"
4
    // 这里的 /path/to/vcpkg 替换为你实际的 vcpkg 路径
5
    // 对于 Windows 平台，使用符合 Windows 格式的路径
6
  },
7
  "cmake.generator": "Ninja",  // 对于 macOS 和 Linux 平台，使用 "Unix Makefiles"
8
  "cmake.buildDirectory": "${workspaceFolder}/build"
9
}