使用CMake时如何避免传递依赖造成的编译阻塞？

你遇到的核心问题是PUBLIC关键字会强制建立全生命周期依赖（编译+链接都等待依赖目标完成），但实际上编译阶段仅需头文件，无需等待库编译完成。CMake 3.12+提供了简洁的解决方式，通过拆分依赖类型实现编译并行化：

核心思路 #

1. 用target_include_directories(INTERFACE ...)暴露库的头文件目录，让依赖目标编译时自动获取头文件，无需等待库产物生成。
2. 用$<LINK_ONLY:target>生成器表达式，仅在链接阶段建立目标间的依赖关系，编译阶段允许并行执行。
3. 保留PUBLIC/PRIVATE关键字控制依赖传递性，确保最终可执行文件能自动链接所有依赖库。

调整后的CMake配置示例 #

lib2的CMakeLists.txt

add_library(lib2 src/lib2.cpp)
# 暴露头文件目录，让依赖lib2的目标编译时可访问
target_include_directories(lib2 
  INTERFACE 
    ${CMAKE_CURRENT_SOURCE_DIR}/include
)

lib1的CMakeLists.txt

add_library(lib1 src/lib1.cpp)
# 暴露自己的头文件给上层目标（ex1）
target_include_directories(lib1 
  INTERFACE 
    ${CMAKE_CURRENT_SOURCE_DIR}/include
)
# 仅在链接阶段依赖lib2，编译阶段不等待lib2完成
target_link_libraries(lib1 
  PUBLIC 
    $<LINK_ONLY:lib2>
)

ex1的CMakeLists.txt

add_executable(ex1 src/ex1.cpp)
# 仅在链接阶段依赖lib1，编译阶段不等待lib1完成
target_link_libraries(ex1 
  PUBLIC 
    $<LINK_ONLY:lib1>
)

原理说明 #

• 头文件依赖独立：INTERFACE类型的头文件目录会自动传递给所有依赖目标，编译时仅需读取头文件，无需等待依赖库编译完成。
• 链接依赖延迟：$<LINK_ONLY>会让CMake仅在链接阶段检查依赖目标是否完成，编译阶段允许所有源文件并行构建，充分利用集群资源。
• 依赖传递保留：PUBLIC关键字确保lib1对lib2的链接依赖会传递给ex1，无需在ex1中重复声明链接lib2。

旧版本CMake兼容方案（<3.12） #

如果无法使用$<LINK_ONLY>，可手动移除编译阶段的强制依赖：

# lib1的配置示例
target_link_libraries(lib1 PUBLIC lib2)
# 清除编译阶段的依赖，仅保留链接依赖
set_property(TARGET lib1 PROPERTY INTERFACE_COMPILE_DEPENDS "")

该方法需要更细致的调整，优先推荐使用$<LINK_ONLY>方案。

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