C++ VSCode CMake VCPKG:清单未启用

基础概念

C++ 是一种通用的编程语言，广泛应用于系统软件、游戏开发、嵌入式系统等领域。VSCode（Visual Studio Code）是一款轻量级但功能强大的源代码编辑器，支持多种编程语言。CMake 是一个跨平台的开源构建系统，用于自动化软件的编译过程。VCPKG 是一个由微软提供的包管理器，用于简化 C++ 库的管理和安装。

清单未启用的问题

当你在 VSCode 中使用 CMake 和 VCPKG 时，可能会遇到“清单未启用”的错误。这通常是因为 VCPKG 的清单文件没有正确配置或启用。

原因

1. 清单文件未生成：VCPKG 在安装库后需要生成清单文件，如果这个步骤没有完成，就会导致清单未启用。
2. 环境变量未设置：VCPKG 的环境变量没有正确设置，导致 VSCode 无法找到清单文件。
3. CMake 配置问题：CMakeLists.txt 文件中没有正确配置 VCPKG 的路径或清单文件。

解决方法

1. 生成清单文件

确保你已经安装了 VCPKG，并且库已经正确安装。然后在 VCPKG 的安装目录下运行以下命令生成清单文件：

./vcpkg integrate install

2. 设置环境变量

确保 VCPKG 的环境变量已经正确设置。你可以在终端中运行以下命令来设置环境变量：

export VCPKG_ROOT=/path/to/vcpkg
export PATH=$VCPKG_ROOT/bin:$PATH

然后在 VSCode 中打开一个新的终端窗口，确保环境变量已经生效。

3. 配置 CMakeLists.txt

在你的 CMakeLists.txt 文件中添加以下内容，以确保 CMake 能够找到 VCPKG 和清单文件：

set(CMAKE_TOOLCHAIN_FILE /path/to/vcpkg/scripts/buildsystems/vcpkg.cmake)

确保 /path/to/vcpkg 是你的 VCPKG 安装路径。

示例代码

假设你有一个简单的 C++ 项目结构如下：

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

你的 CMakeLists.txt 文件可以这样配置：

cmake_minimum_required(VERSION 3.0)
project(my_project)

set(CMAKE_TOOLCHAIN_FILE /path/to/vcpkg/scripts/buildsystems/vcpkg.cmake)

add_executable(my_project src/main.cpp)

target_link_libraries(my_project PRIVATE boost_system)

然后在终端中运行以下命令来构建项目：

mkdir build
cd build
cmake ..
make

参考链接

• VCPKG 官方文档
• VSCode CMake Tools 插件文档

通过以上步骤，你应该能够解决“清单未启用”的问题，并成功在 VSCode 中使用 CMake 和 VCPKG 进行 C++ 开发。