CMake仅引用OpenCV头文件时如何配置无冗余构建依赖

你遇到的是非常典型的仅使用第三方库纯头文件能力、无需链接对应编译产物的配置场景，核心矛盾是原有的两种写法都存在硬伤：

• 直接链接opencv_core的写法，会把整个库的链接需求无差别传递，哪怕链接器最终会丢弃所有未引用的目标文件，CMake层面的依赖图会被污染——所有依赖lib1的下游模块都会被强加opencv_core的链接关联，完全不符合真实的依赖关系。
• 直接使用${OpenCV_INCLUDE_DIRS}全局变量的写法，绕开了现代CMake的目标属性体系，不仅会把OpenCV全组件的头文件路径无差别引入，还容易出现路径优先级混乱、版本校验失效的问题。

核心配置思路 #

OpenCV的Vec/Matx类完全基于头文件实现，没有任何需要链接的导出符号，你对OpenCV的实际需求仅仅是：

• 获取与当前OpenCV版本严格匹配的头文件搜索路径
• 拿到头文件展开时必须的编译定义（比如版本宏、CPU指令集开关）
• 完全不需要把opencv_core的编译产物加入任何目标的链接命令行

具体实现方案 #

基础版：适配当前lib1的配置 #

不需要改动find_package的定位逻辑，但是要从IMPORTED的opencv_core目标上提取仅和头文件相关的属性，不要引入链接需求：

find_package(OpenCV REQUIRED COMPONENTS core)

add_library(lib1 STATIC
    src/a.cpp
)

# 从官方IMPORTED目标上提取头文件需要的属性，不使用全局变量
get_target_property(OCV_CORE_INCLUDE_DIRS opencv_core INTERFACE_INCLUDE_DIRECTORIES)
get_target_property(OCV_CORE_COMPILE_DEFS opencv_core INTERFACE_COMPILE_DEFINITIONS)

# 根据Vec类的使用范围设置可见性
# 1. 如果Vec类仅在lib1的cpp实现文件中使用，对外头文件完全不暴露OpenCV类型，设置为PRIVATE
# 2. 如果lib1的对外头文件直接用到cv::Vec/cv::Matx类型，需要设置为PUBLIC，保证下游编译时能找到对应头文件
target_include_directories(lib1
    PRIVATE # 或 PUBLIC
        ${OCV_CORE_INCLUDE_DIRS}
)
target_compile_definitions(lib1
    PRIVATE # 或 PUBLIC，和上面的可见性保持一致
        ${OCV_CORE_COMPILE_DEFS}
)

这种写法的优势：

• 不会在任何链接命令行加入opencv_core的编译产物，完全消除不必要的链接开销
• 不会造成依赖关系污染，下游模块不会感知到对OpenCV的隐式依赖
• 完全复用OpenCV官方构建的路径配置，不会出现头文件版本不匹配的问题
• 没有使用聚合全OpenCV路径的全局变量，和官方构建系统的属性逻辑保持一致

进阶版：项目内可复用的接口目标 #

如果项目内有多个模块都需要用到OpenCV的纯头文件结构，可以在顶层CMake中定义一个专门的INTERFACE类型目标，统一管理这类纯头文件依赖，避免重复写提取属性的逻辑：

# 在项目顶层CMake中定义
find_package(OpenCV REQUIRED COMPONENTS core)

add_library(OpenCV::HeaderOnly INTERFACE IMPORTED GLOBAL)
# 仅继承opencv_core的头文件和编译定义属性，不引入任何链接需求
set_target_properties(OpenCV::HeaderOnly
    PROPERTIES
        INTERFACE_INCLUDE_DIRECTORIES "$<TARGET_PROPERTY:opencv_core,INTERFACE_INCLUDE_DIRECTORIES>"
        INTERFACE_COMPILE_DEFINITIONS "$<TARGET_PROPERTY:opencv_core,INTERFACE_COMPILE_DEFINITIONS>"
)

后续任意模块需要用到纯头文件的Vec/Matx，只需要正常链接这个目标即可：

target_link_libraries(lib1
    PUBLIC # 根据是否在公共头文件暴露OpenCV类型选择可见性
        OpenCV::HeaderOnly
)

因为这个自定义目标是纯INTERFACE类型，CMake在处理时不会产生任何实际的链接行为，只会传递对应的头文件路径和编译定义，完全符合现代CMake的目标导向设计，没有全局变量的滥用，也没有依赖泄漏，和CMake官方推荐的纯头文件依赖管理逻辑完全一致。

需要规避的常见误区 #

• 不要为了图省事把opencv_core设为PRIVATE链接：哪怕是PRIVATE级别，CMake依然会把opencv_core的库文件路径加入lib1自身的链接命令，不仅增加不必要的链接开销，还会让CMake的依赖图记录一个根本不需要的链接关联，和实际需求不符。
• 不要单独把matx.hpp拷贝到项目内使用：这个头文件会依赖OpenCV内部的基础配置头（比如cvdef.h、类型定义头），单独拷贝很容易出现漏依赖、版本不匹配的问题，直接复用官方IMPORTED目标的属性是最稳妥的方案。
• 不要依赖OpenCV提供的全局跳过链接开关：这类全局开关会影响所有依赖OpenCV的模块配置，灵活性远不如自定义的接口目标，很容易误影响那些真的需要链接OpenCV编译产物的模块。

内容的提问来源于stack exchange，提问作者simplename