首先需设置CMAKE_TOOLCHaiN_FILE指向vcpkg的toolchain文件，使CMake能自动查找vcpkg安装的库；然后通过vcpkg install安装所需库，并在CMakeLists.txt中使用find_package链接，注意库的triplet需与构建平台匹配。

要在CMake项目中使用通过vcpkg安装的c++库，关键在于让CMake找到vcpkg提供的工具链文件。vcpkg会自动生成一个toolchain文件，用来告诉CMake去哪里查找已安装的库和头文件。

1. 确保vcpkg已正确安装并集成到CMake

如果你还没将vcpkg与CMake集成，先运行以下命令：

vcpkg integrate install

这个命令会设置全局钩子，使CMake自动识别vcpkg管理的库。但更推荐在项目中显式指定toolchain文件，避免影响其他项目。

2. 在CMake中指定vcpkg toolchain文件

在调用CMake时，通过 CMAKE_TOOLCHAIN_FILE 指向vcpkg的toolchain.cmake文件。假设vcpkg安装在 D:/vcpkg（windows）或 ~/vcpkg（linux/macOS），则：

立即学习“C++免费学习笔记（深入）”；

cmake -DCMAKE_TOOLCHAIN_FILE=D:/vcpkg/scripts/buildsystems/vcpkg.cmake ..

或者在脚本中写成：

cmake -DCMAKE_TOOLCHAIN_FILE=~/vcpkg/scripts/buildsystems/vcpkg.cmake ..

这样CMake就能自动在vcpkg的安装目录中查找库。

AI卡通生成器

免费在线AI卡通图片生成器 | 一键将图片或文本转换成精美卡通形象

51

查看详情

3. 在CMakeLists.txt中链接库

一旦toolchain设置完成，就可以像使用find_package一样使用vcpkg安装的库。例如，你通过vcpkg安装了opencv：

vcpkg install opencv4

然后在 CMakeLists.txt 中这样写：

find_package(OpenCV REQUIred)
add_executable(myapp main.cpp)
target_link_libraries(myapp private ${OpenCV_LIBS})

对于支持CMake config模式的库（如fmt、nlohmann_json），可以直接使用目标名：

find_package(fmt REQUIRED)
target_link_libraries(myapp PRIVATE fmt::fmt)

4. 注意事项

确保安装的库与你的平台匹配。比如在x64系统下构建，应使用：

vcpkg install fmt –triplet=x64-windows

否则可能出现找不到包的问题。CMake会根据当前构建环境自动选择对应的triplet。

基本上就这些。只要正确设置CMAKE_TOOLCHAIN_FILE，CMake就能无缝使用vcpkg管理的库，无需手动指定头文件路径或lib位置。不复杂但容易忽略的是toolchain文件的路径问题，建议在构建脚本中明确传入。