CMake如何链接两个原本独立的项目(项目A新增功能依赖项目B)
核心逻辑先理清
你现在的困惑本质是把CMake里两类独立路径的作用搞混了,先把规则掰清楚再动手就不会走弯路:
target_include_directories是给编译阶段的编译器用的,作用是告诉编译器去哪找代码里#include的头文件,和二进制文件没有任何关系- 链接二进制库是给链接阶段的链接器用的,作用是告诉链接器去哪找代码里调用的函数的实际实现,和源码目录没有任何关系
你的场景是B已经跑通了全量构建流程、有现成的公开头文件和二进制产物,完全不需要在A的构建流程里重新编译B,也不需要把B的源码目录直接纳入A的构建体系,只需要分两步对应配置两个环节的路径即可。
具体实操步骤
第一步:先梳理B的可用产物路径,别瞎加路径
先从B的存放目录里筛两类确定的路径,千万不要上来就把B的整个源码树全塞到CMake配置里:
- 头文件路径:只找B对外公开的头文件存放目录,比如常见的B构建完成后会把头文件统一放到
B根目录/include下,也就是你要引用的那个头文件,以及和它关联的、同层级可对外调用的依赖头所在的目录,不要去翻B源码里散落在各个子目录的内部头文件 - 二进制库路径:找B编译完成后生成的正式产物路径,比如常见的静态库/动态库存放在
B根目录/lib下,Windows的动态库有时候会放在B根目录/bin下,这些才是可以直接被A链接的正式二进制,不要去B的源码构建目录里翻零碎的中间编译产物
第二步:在A的CMake配置里做针对性配置
注意所有配置都要绑定到A里那个新增了B依赖的具体编译目标(比如你最终要生成的可执行文件my_app),别全局乱加编译选项,不然会影响A里其他不依赖B的模块:
- 给编译器配置头文件搜索路径,解决“include头文件找不到”的编译错误
# 替换为你刚才找到的B的公开头文件实际路径 set(B_PUBLIC_INCLUDE_DIR "你的B目录实际路径/include") target_include_directories(my_app PRIVATE ${B_PUBLIC_INCLUDE_DIR} )注意:绝对不要把B的源码根目录加到这里——B的源码目录里可能存在和A项目同名的内部头文件,会导致编译器找错头文件,引发类型不匹配、语法校验失败这类非常难排查的诡异问题。
- 给链接器配置库搜索路径,解决“找不到二进制库文件”的链接错误
# 替换为你刚才找到的B的二进制实际存放路径 set(B_LIBRARY_DIR "你的B目录实际路径/lib") target_link_directories(my_app PRIVATE ${B_LIBRARY_DIR} ) - 显式链接B的功能库,解决“链接时找不到函数符号”的问题
# 这里写库的核心名就行,不要带lib前缀和后缀:比如libB_core.so写B_core,B_core.lib也写B_core target_link_libraries(my_app PRIVATE B_core )
常见踩坑提醒
- 直接回应你最初的疑问:完全不需要把B的源码路径通过CMake配置加给A,也不需要在A的流程里重新构建B;两个核心配置缺一不可:一是加B的公开头路径解决编译阶段的头文件查找问题,二是加B的二进制路径解决链接阶段的符号查找问题,不存在“只加一个就行”的捷径。
- 如果引用的B头文件本身还依赖其他第三方库的头和二进制,这些第三方依赖的路径和库也要对应加到A的配置里——因为你是直接引用B的产物,没有走B自带的包配置传递机制,B构建时用到的依赖不会自动传递给A。
- 动态库场景注意运行时路径问题:Linux下要确保运行时能找到对应的so文件,要么设置
LD_LIBRARY_PATH环境变量,要么通过CMake的rpath配置把B的库路径写入最终可执行文件的搜索路径;Windows下要把对应的dll文件放到和A生成的exe同目录下,避免运行时报“找不到dll”的错误。 - 别图省事直接把B的头文件硬拷贝到A的源码目录里引用,后续B版本更新的时候很容易出现代码和库版本不匹配的问题。
内容的提问来源于stack exchange,提问作者Chris
相关产品推荐
相关产品推荐

