0

0

c++如何用CMake链接第三方库 c++ find_package用法【必看】

尼克

尼克

发布时间:2026-01-06 08:29:33

|

974人浏览过

|

来源于php中文网

原创

CMake链接第三方库应优先使用find_package查找已安装库并链接imported target。它按CMAKE_PREFIX_PATH、系统路径顺序查找Config.cmake或Find*.cmake,成功后定义_FOUND、_INCLUDE_DIRS、_LIBRARIES等变量,并推荐target_link_libraries(myapp PRIVATE Package::component)方式链接。

c++如何用cmake链接第三方库 c++ find_package用法【必看】

在 C++ 项目中用 CMake 链接第三方库,核心是让 CMake 找到库的头文件路径、链接库文件,并把它们正确传递给编译器和链接器。find_package 是最常用、最推荐的方式,尤其对已提供 *Config.cmake*-config.cmake 文件(或 Find*.cmake 模块)的库而言。

find_package 的基本用法和查找逻辑

find_package 不是“自动下载安装”,而是“定位已安装的库”。它按固定顺序查找:

  • 先查 CMAKE_PREFIX_PATH 指定的路径下是否有 Config.cmake-config.cmake
  • 再查系统默认路径(如 /usr/local/lib/cmake/xxx//opt/homebrew/lib/cmake/xxx/、Windows 的 C:/Program Files/xxx/share/xxx/ 等)
  • 若没找到 Config 版本,且没加 NO_MODULE,则尝试加载内置或自定义的 Find.cmake 模块(比如 FindOpenCV.cmake

成功后,通常会定义:
_FOUND(是否找到)、
_INCLUDE_DIRS_INCLUDE_DIR(头文件路径)、
_LIBRARIES_LIBRARY(要链接的库目标或路径)。

实际写法:以 OpenCV 和 Boost 为例

✅ 正确写法(推荐使用目标式链接,现代 CMake 风格):

立即学习C++免费学习笔记(深入)”;

# 查找 OpenCV(要求 4.5.0+,REQUIRED 表示找不到就报错)
find_package(OpenCV 4.5 REQUIRED)

创建可执行文件

add_executable(myapp main.cpp)

直接链接 OpenCV 提供的 imported target(无需手动处理路径和依赖)

target_link_libraries(myapp PRIVATE ${OpenCV_LIBS}) # 旧写法(兼容性好)

魔珐星云
魔珐星云

无需昂贵GPU,一键解锁超写实/二次元等多风格3D数字人,跨端适配千万级并发的具身智能平台。

下载

或更推荐:

target_link_libraries(myapp PRIVATE OpenCV::opencv_core OpenCV::opencv_imgproc)

✅ Boost 示例(组件式查找):

# 查找 Boost,只找需要的组件(thread + system),静态链接
find_package(Boost 1.70 REQUIRED COMPONENTS thread system)

add_executable(myapp main.cpp) target_link_libraries(myapp PRIVATE Boost::thread Boost::system)

⚠️ 注意:Boost::* 这类 imported target 是 CMake 从 1.70+ 官方推荐方式,比 ${Boost_LIBRARIES} 更安全(自动处理调试/发布、静态/动态、依赖传递)。

找不到库?常见解决办法

  • 确认库已安装:运行 pkg-config --modversion opencv4(Linux/macOS)或检查安装目录是否存在 *Config.cmake
  • 手动指定路径:用 -DCMAKE_PREFIX_PATH=/path/to/opencv 传给 cmake 命令,或在 CMakeLists.txt 中提前设置:set(CMAKE_PREFIX_PATH "/opt/mylib;/usr/local")
  • 用 find_path + find_library 手动定位(兜底方案,不推荐但有时必须):
find_path(MYLIB_INCLUDE_DIR NAMES mylib.h PATHS /usr/include/mylib /opt/mylib/include)
find_library(MYLIB_LIBRARY NAMES mylib PATHS /usr/lib /opt/mylib/lib)

if(NOT MYLIB_INCLUDE_DIR OR NOT MYLIB_LIBRARY) message(FATAL_ERROR "mylib not found!") endif()

add_library(mylib_imported INTERFACE) target_include_directories(mylib_imported INTERFACE ${MYLIB_INCLUDE_DIR}) target_link_libraries(mylib_imported INTERFACE ${MYLIB_LIBRARY})

进阶技巧:导入自定义库或未提供 Config 的库

如果第三方库只提供 .a/.so/.dll 和头文件(比如某些 SDK),可封装为 IMPORTED 库:

add_library(thirdparty_lib SHARED IMPORTED)
set_target_properties(thirdparty_lib PROPERTIES
  IMPORTED_LOCATION "${CMAKE_SOURCE_DIR}/lib/libthirdparty.so"
  INTERFACE_INCLUDE_DIRECTORIES "${CMAKE_SOURCE_DIR}/include"
)

add_executable(app main.cpp) target_link_libraries(app PRIVATE thirdparty_lib)

这样既复用 CMake 的依赖管理,又避免硬编码路径。

不复杂但容易忽略:始终优先用 find_package(... REQUIRED) + imported target;手动路径是备选,不是默认方案。

相关专题

更多
windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

558

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1079

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

774

2023.08.01

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

445

2023.08.02

windows无法访问共享电脑
windows无法访问共享电脑

在现代社会中,共享电脑是办公室和家庭的重要组成部分。然而,有时我们可能会遇到Windows无法访问共享电脑的问题。这个问题可能会导致数据无法共享,影响工作和生活的正常进行。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2345

2023.08.08

windows自动更新
windows自动更新

Windows操作系统的自动更新功能可以确保系统及时获取最新的补丁和安全更新,以提高系统的稳定性和安全性。然而,有时候我们可能希望暂时或永久地关闭Windows的自动更新功能。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

773

2023.08.10

windows boot manager
windows boot manager

windows boot manager无法开机的解决方法:1、系统文件损坏,使用Windows安装光盘或USB启动盘进入恢复环境,选择修复计算机,然后选择自动修复;2、引导顺序错误,进入恢复环境,选择命令提示符,输入命令"bootrec /fixboot"和"bootrec /fixmbr",然后重新启动计算机;3、硬件问题,使用硬盘检测工具进行扫描和修复;4、重装操作系统。本专题还提供其他解决

1484

2023.08.28

windows锁屏快捷键
windows锁屏快捷键

windows锁屏快捷键是Windows键+L、Ctrl+Alt+Del、Windows键+D、Windows键+P和Windows键+R。本专题为大家提供windows相关的文章、下载、课程内容,供大家免费下载体验。

1613

2023.08.30

PPT动态图表制作教程大全
PPT动态图表制作教程大全

本专题整合了PPT动态图表制作相关教程,阅读专题下面的文章了解更多详细内容。

12

2026.01.07

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL 教程
PostgreSQL 教程

共48课时 | 6.7万人学习

Git 教程
Git 教程

共21课时 | 2.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号