讲师中心 微信公众号
AI工具推荐 视频效率加速

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

星伟大大_5161

星伟大大_5161

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

|

1054人浏览过

|

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

成功后,通常会定义:
<PackageName>_FOUND(是否找到)、
<PackageName>_INCLUDE_DIRS 或 <PackageName>_INCLUDE_DIR(头文件路径)、
<PackageName>_LIBRARIES 或 <PackageName>_LIBRARY(要链接的库目标或路径)。

实际写法:以 OpenCV 和 Boost 为例

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

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

# 查找 OpenCV(要求 4.5.0+,REQUIRED 表示找不到就报错)
find_package(OpenCV 4.5 REQUIRED)
<h1>创建可执行文件</h1><p>add_executable(myapp main.cpp)</p><div class="aritcle_card flexRow">
                                                        <div class="artcardd flexRow">
                                                                <a class="aritcle_card_img" href="/xiazai/skill4570" title="linux-performance-analyzer"><img
                                                                                src="https://img.php.cn/upload/skill/000/000/081/179013069298656.jpg" alt="linux-performance-analyzer"  onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
                                                                <div class="aritcle_card_info flexColumn">
                                                                        <a href="/xiazai/skill4570" title="linux-performance-analyzer">linux-performance-analyzer</a>
                                                                        <p>Linux 性能分析与调优专家,覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景:系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。</p>
                                                                </div>
                                                                <a href="/xiazai/skill4570" title="linux-performance-analyzer" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
                                                        </div>
                                                </div><h1>直接链接 OpenCV 提供的 imported target(无需手动处理路径和依赖)</h1><p>target_link_libraries(myapp PRIVATE ${OpenCV_LIBS})  # 旧写法(兼容性好)</p><h1>或更推荐:</h1><p>target_link_libraries(myapp PRIVATE OpenCV::opencv_core OpenCV::opencv_imgproc)

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

# 查找 Boost,只找需要的组件(thread + system),静态链接
find_package(Boost 1.70 REQUIRED COMPONENTS thread system)
<p>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)
<p>if(NOT MYLIB_INCLUDE_DIR OR NOT MYLIB_LIBRARY)
message(FATAL_ERROR "mylib not found!")
endif()</p><p>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"
)
<p>add_executable(app main.cpp)
target_link_libraries(app PRIVATE thirdparty_lib)

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

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

相关文章

c++速学教程(入门到精通)
c++速学教程(入门到精通)

c++怎么学习?c++怎么入门?c++在哪学?c++怎么学才快?不用担心,这里为大家提供了c++速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

相关专题

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

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

3039

2023.07.26

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

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

2598

2023.07.27

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

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

1428

2023.08.01

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

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

2379

2023.08.02

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

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

3210

2023.08.08

windows自动更新
windows自动更新

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

1477

2023.08.10

windows boot manager
windows boot manager

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

2397

2023.08.28

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

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

4287

2023.08.30

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

80

2026.09.23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn