CMake Windows怎么链接第三方库?

冬枫酱_1524

冬枫酱_1524

2026-08-10

966人浏览

原创

最稳妥的方式是使用find_package(tbb required config)并链接tbb::tbb,因其能自动适配路径、构建类型及组件;若无tbbconfig.cmake,则用find_path与find_library手动定位头文件和库,再通过target_include_directories和target_link_libraries引入,同时需显式处理debug/release对应的dll复制。

cmake windows怎么链接第三方库?

find_package 是 Windows 上链接第三方库最稳妥的方式,但直接写 target_link_libraries(my_app tbb) 很可能在不同机器上失败——它依赖系统路径、头文件位置、甚至库的命名规则(比如 tbb.dll vs tbb.lib vs libtbb.a),而 Windows 没有统一的默认安装位置。

为什么不能直接用 target_link_libraries(my_app tbb)

这条命令会让 CMake 去默认路径(如 C:/Program Files/tbb/lib 或环境变量 LIB 路径)找 tbb.lib,同时假定头文件在 C:/Program Files/tbb/include。但现实是:

  • 你装的 tbb 可能在 C:/Users/xxx/tbb-2021.5,而别人在 D:/dev/libs/tbb
  • 你用的是预编译二进制包,里面只有 tbb.dlltbb.lib,但没提供 tbbConfig.cmake 文件,find_package(tbb) 就会失败
  • VS 编译器对 Debug/Release 库名区分严格:tbb.lib(Release)和 tbb_debug.lib(Debug),硬写 tbb 会导致 Debug 构建链接失败

find_package(... CONFIG) 才是 Windows 友好方案

只要第三方库提供了 XXXConfig.cmake(比如 vcpkg、conan 或官方预编译包通常自带),就优先走这条路。它能自动适配路径、组件、构建类型:

  • 先确认你手上的 tbb 是否含 tbbConfig.cmake:打开解压目录,搜 *Config.cmake*-config.cmake
  • 如果找到了,设置 tbb_DIR 指向其所在目录(不是根目录,而是包含 tbbConfig.cmake 的那个子目录,通常是 lib/cmake/tbb/
  • 写法示例:
set(tbb_DIR "C:/Users/archibate/installed/tbb/lib/cmake/tbb")
find_package(TBB REQUIRED CONFIG)
target_link_libraries(my_app PRIVATE TBB::tbb)

注意:TBB::tbb 是 IMPORTED target 名,不是字符串 "tbb";大小写敏感,且必须用 :: 命名空间形式。

找不到 XXXConfig.cmake?用 find_library + find_path 手动定位

这是 Windows 下最常 fallback 的方式,比硬写绝对路径安全,也比 link_directories 更可控:

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

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

下载
  • find_path 查头文件目录(对应 #include <tbb></tbb>
  • find_library.lib(不是 .dll!链接时需要 .lib,运行时才要 .dll)
  • 把结果传给 target_include_directoriestarget_link_libraries,避免污染全局作用域
find_path(TBB_INCLUDE_DIR NAMES tbb/parallel_for.h HINTS "C:/Users/archibate/installed/tbb/include")
find_library(TBB_LIBRARY NAMES tbb tbb_debug HINTS "C:/Users/archibate/installed/tbb/lib")
if(NOT TBB_INCLUDE_DIR OR NOT TBB_LIBRARY)
  message(FATAL_ERROR "TBB not found: include=${TBB_INCLUDE_DIR}, lib=${TBB_LIBRARY}")
endif()
target_include_directories(my_app PRIVATE ${TBB_INCLUDE_DIR})
target_link_libraries(my_app PRIVATE ${TBB_LIBRARY})

关键点:HINTS 支持多个路径,也可用 PATHS 强制搜索;NAMES 列出所有可能的库名(tbbtbb_debugtbb_preview 等),让 CMake 自动选匹配当前构建类型的那个。

运行时 dll 怎么放?别只靠 PATH

Windows 链接成功 ≠ 运行成功。tbb.dll 必须被加载器找到,常见做法:

  • tbb.dll 复制到可执行文件同目录(cmake --install 时用 file(COPY ...)INSTALL(DIRECTORY ...)
  • 在 CMake 中用 add_custom_command 在 build 后自动复制:
add_custom_command(TARGET my_app POST_BUILD
  COMMAND ${CMAKE_COMMAND} -E copy_if_different
    "$<tbb>/tbb.dll"
    "$<my_app>/tbb.dll")</my_app></tbb>

注意:$<tbb></tbb> 仅在 tbb 是 IMPORTED target 时有效;若手动找库,则需写死路径或用 get_filename_component 提取目录。

真正容易被忽略的是:Debug 和 Release 的 dll 名往往不同(tbb_debug.dll vs tbb.dll),而 Visual Studio 默认不自动复制任何 dll —— 不显式处理,程序双击就报“找不到 tbb.dll”。

相关文章

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

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

下载

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

相关专题

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

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

2023.07.26

2979

3

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

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

2023.07.27

2538

6

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

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

2023.08.01

1408

3

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

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

2023.08.02

2319

5

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

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

2023.08.08

3190

4

windows自动更新
windows自动更新

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

2023.08.10

1457

3

windows boot manager
windows boot manager

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

2023.08.28

2377

4

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

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

2023.08.30

4147

5

Window.setInterval()方法
Window.setInterval()方法

Window.setInterval() 方法的基本语法是“window.setInterval(function, delay)”,function是要重复执行的函数或代码块,delay是每次执行之间的时间间隔,以毫秒为单位。本专题为大家提供Window.setInterval()相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

595

3

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

共0课时 | 0人学习