CMake find_package怎么查找源码安装的库?

老雪同学_2114

老雪同学_2114

2026-08-09

411人浏览

原创

find_package只查找已安装的库,需先执行make install生成xxxconfig.cmake并置于cmake可搜索路径;若未安装或配置不全,则需手动设置cmake_prefix_path或foo_dir,或退用find_path/find_library等底层命令。

cmake find_package怎么查找源码安装的库?

直接给结论:find_package 本身不查找源码,它只查找**已安装**的库——也就是说,你必须先 make install(或等效操作),让库把 xxxConfig.cmakeFindxxx.cmake 放到 CMake 能扫到的位置,find_package 才可能生效。

为什么源码目录里调 find_package 总是失败?

因为 find_package 的搜索路径默认不含你的源码根目录或 build/ 目录。它按固定顺序查:

  • CMAKE_PREFIX_PATH 指定的路径(优先级最高)
  • /usr/local/opt/homebrewC:/Program Files/ 等系统级安装前缀
  • CMake 自带模块路径(如 FindOpenCV.cmake

源码编译后若没 install,头文件和库文件就散落在 build/src/ 里,find_package 压根不会进去翻。

想用 find_package 找自己刚编译的库,必须做三件事

以你刚从 GitHub clone 并 cmake && make 编译完的 libfoo 为例:

  • 确认该库的 CMakeLists.txt 里有 install(EXPORT ...)export(PACKAGE ...),否则 make install 不会生成 FooConfig.cmake
  • 执行 make install(或 cmake --install . --prefix /path/to/install),把配置文件和库装到某个目录(比如 /tmp/foo-install
  • 在你的项目 CMakeLists.txt 中提前设置:set(CMAKE_PREFIX_PATH "/tmp/foo-install ${CMAKE_PREFIX_PATH}")

之后再写 find_package(Foo REQUIRED),CMake 就会去 /tmp/foo-install 下找 FooConfig.cmake

install 权限或不想装系统?试试 Config 模式手动指定路径

如果只是临时测试,又不能 sudo make install,可以绕过搜索逻辑,直接告诉 CMake 配置文件在哪:

C++ 算法竞赛自动化测试数据生成与校验框架
C++ 算法竞赛自动化测试数据生成与校验框架

根据原题生成新题面、验证器及完整测试数据,自动套用 testlib 模板,用于用户要求生成测试数据时。

下载
  • 先手动找到生成的 FooConfig.cmake(通常在 build/install/lib/cmake/foo/build/lib/cmake/foo/
  • find_package 前加:set(Foo_DIR "/path/to/FooConfig.cmake/dir")
  • 再调用:find_package(Foo REQUIRED)

注意:Foo_DIR 必须指向包含 FooConfig.cmake 的**目录**,不是文件路径;且这个变量名严格匹配包名(大小写敏感)。

实在没法走 Config 模式?退回到 Module 模式或底层命令

当源码库没提供 FooConfig.cmake,也没自带 FindFoo.cmake 时,find_package(Foo) 会 fallback 到 Module 模式,但大概率失败——因为 CMake 自带的 Find*.cmake 不可能覆盖所有小众库。

这时更实际的做法是跳过 find_package,改用底层命令:

  • find_path(FOO_INCLUDE_DIR NAMES foo.h PATHS ${FOO_SOURCE_DIR}/include)
  • find_library(FOO_LIBRARY NAMES foo PATHS ${FOO_BUILD_DIR}/lib)
  • 然后手动 target_include_directories(myapp PRIVATE ${FOO_INCLUDE_DIR})target_link_libraries(myapp PRIVATE ${FOO_LIBRARY})

这不是最佳实践,但对未打包的源码依赖,它最可控、最少坑。

真正容易被忽略的是:Config 模式依赖库作者是否规范导出目标。很多开源项目只做了 install(TARGETS ...),却漏了 install(EXPORT ...),导致 FooConfig.cmake 根本不生成——这种情况下,哪怕你 make install 了,find_package 还是找不到。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

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

下载

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

相关专题

更多
C++ 跨平台开发
C++ 跨平台开发

本专题聚焦 C++ 在跨平台应用与工程构建中的实战应用,系统讲解 CMake 构建系统、跨平台编译配置、第三方库集成、调试技巧、静态与动态链接库管理等核心知识。通过实战案例(如跨平台工具开发、Linux与Windows编译兼容性项目),帮助学习者掌握 从环境配置到完整跨平台构建的开发能力。

2025.10.17

5306

15

c++  cmake用法
c++ cmake用法

本专题整合了c++ cmake用法相关教程,阅读专题下面的文章了解更多详细内容。

2025.10.23

1391

14

C++ 编译构建系统与CMake实战
C++ 编译构建系统与CMake实战

本专题聚焦 C++ 项目的编译与构建体系,系统讲解 CMake 的核心语法、项目结构设计、库与依赖管理、跨平台构建、调试与发布配置。通过完整项目示例,帮助开发者掌握 从源码到可执行程序的工程化构建流程,提升 C++ 项目在实际开发中的可维护性与扩展性。

2025.12.13

314

18

NumPy性能优化版本更新与常见报错排查
NumPy性能优化版本更新与常见报错排查

本专题整理 NumPy 性能优化、版本更新与常见报错排查相关教程,覆盖向量化计算、广播性能、内存布局、NumPy 2.0 升级、版本兼容冲突、安装导入报错、dtype 溢出、矩阵运算异常和 broadcasting 报错修复,帮助读者系统掌握 NumPy 性能调优与问题定位方法。

2026.09.22

0

25

Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程,涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作,并整理了免费版水印规则与手机端浏览器访问指南,助你快速将知识内容视频化。

2026.09.21

20

20

NumPy随机数文件读写与dtype数据类型
NumPy随机数文件读写与dtype数据类型

本专题整理 NumPy 随机数、文件读写与 dtype 数据类型相关教程,覆盖 Generator/random、随机数种子、正态分布采样、npy/npz/CSV/TXT 保存读取、loadtxt/savetxt、memmap、大文件处理、astype 类型转换、结构化 dtype、整数溢出和精度丢失等场景。

2026.09.21

20

24

NumPy矩阵运算与线性代数计算
NumPy矩阵运算与线性代数计算

本专题整理 NumPy 矩阵运算与线性代数计算相关教程,覆盖矩阵乘法、dot 与 @ 运算符、逆矩阵、行列式、特征值与特征向量、SVD、线性方程组、欧氏距离、矩阵分解和大规模矩阵性能优化等内容,帮助读者掌握 np.linalg 与矩阵计算实战。

2026.09.21

0

20

NumPy广播机制数学运算与统计分析
NumPy广播机制数学运算与统计分析

本专题整理 NumPy 广播机制、数组数学运算与统计分析相关教程,覆盖广播规则、维度对齐、矩阵与数组加减除法、向量化计算、均值方差、分位数、中位数、直方图和 unique 频次统计等场景,帮助读者掌握 ndarray 高效计算与统计处理方法。

2026.09.21

0

17

NumPy数组创建索引切片与数据选择
NumPy数组创建索引切片与数据选择

本专题整理 NumPy 数组创建、索引、切片与数据选择相关教程,覆盖 np.array、zeros/ones、多维数组形状、基础切片、花式索引、布尔索引、条件筛选、视图与副本等常用场景,帮助读者系统掌握 ndarray 数据构造与高效提取方法。

2026.09.21

0

12

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习

Conan 2 入门教程
Conan 2 入门教程

共0课时 | 0人学习

CLion CMake 快速入门教程
CLion CMake 快速入门教程

共0课时 | 0人学习