CMake 中的 PUBLIC，PRIVATE，INTERFACE

最新推荐文章于 2025-08-12 22:18:15 发布

转载最新推荐文章于 2025-08-12 22:18:15 发布 · 850 阅读

7 ·

CC 4.0 BY-SA版权

原文链接：https://www.jianshu.com/p/07761ff7838e

文章标签：

#p2p #tv #网络协议

cmake 专栏收录该内容

9 篇文章

订阅专栏

本文详细介绍了CMake中target_link_libraries命令的PUBLIC, PRIVATE, INTERFACE三个关键字的区别。PRIVATE依赖只影响直接链接的目标，INTERFACE依赖则会传播给链接该目标的所有目标，而PUBLIC依赖同时具备两者特性。通过这三个关键字，可以精确控制库的依赖传播。建议在项目中合理使用以避免不必要的目录包含和链接。

部署运行你感兴趣的模型镜像

一、概述

CMake中经常会使用 target_**() 相关命令，target_**() 命令支持通过 PUBLIC，PRIVATE 和 INTERFACE 关键字来控制传播。本文主要介绍下这三个关键字的区别。

二、解释

以 target_link_libraries(A B) 命令为例，从理解的角度解释：

PRIVATE 依赖项 B 仅链接到目标 A，若有 C 链接了目标 A，C 不链接依赖项 B 。
INTERFACE 依赖项 B 并不链接到目标 A，若有 C 链接了目标 A，C 会链接依赖项 B 。
PUBLIC 依赖项 B 链接到目标 A，若有 C 链接了目标 A，C 也会链接依赖项 B 。

从使用的角度解释，若有 C 链接了目标 A ：

如果依赖项 B 仅用于目标 A 的实现，且不在头文件中提供给 C 使用，使用 PRIVATE 。
如果依赖项 B 不用于目标 A 的实现，仅在头文件中作为接口提供给 C 使用，使用 INTERFACE 。
如果依赖项 B 不仅用于目标 A 的实现，而且在头文件提供给 C 使用，使用 PUBLIC 。

例子

举一个简单的例子说明一下

add_library(C c.cpp)
add_library(D d.cpp)

add_library(B b.cpp)
target_link_libraries(B PUBLIC C)
target_link_libraries(B PRIVATE D)

add_executable(A a.cpp)
target_link_libraries(A B)

因为 C 是 B 的 PUBLIC 依赖项，所以其会被传播到 A 。
因为 D 是 B 的 PRIVATE 依赖项，所以其不会传播到 A 。

三、补充

这里补充下使用 target_**()相关命令，有无 target 的区别。

以 target_include_directories() 命令为例，include_directories(dir) 是一个全局设置，其会将 dir 添加到当前 CMakeLists 文件中每个目标的 INCLUDE_DIRECTORIES 属性中。即当前 CMakeLists 文件其下所有的子目录都会添加 dir 目录。

因此，建议使用有 target 的命令来减少不必要或多余的目录包含和链接。