CMake编译中target_link_libraries中属性PRIVATE、PUBLIC、INTERFACE含义

最新推荐文章于 2025-06-14 12:48:04 发布
最新推荐文章于 2025-06-14 12:48:04 发布
阅读量2.8w 收藏 27
点赞数 5
CC 4.0 BY-SA版权
分类专栏： # Compile
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/turbock/article/details/90034787

当创建动态库时，

  • 如果源文件(例如CPP)中包含第三方头文件，但是头文件（例如hpp）中不包含该第三方文件头，采用PRIVATE。
  • 如果源文件和头文件中都包含该第三方文件头，采用PUBLIC。
  • 如果头文件中包含该第三方文件头，但是源文件(例如CPP)中不包含，采用 INTERFACE。

原文：CMake target_link_libraries Interface Dependencies

http://stackoverflow.com/questions/26037954/cmake-target-link-libraries-interface-dependencies

其他属性可以参考http://www.cmake.org/cmake/help/v3.0/manual/cmake-buildsystem.7.html#transitive-usage-requirements

cmake语法target_link_libraries private,public,interface解读
有问题或资源连接有缺失的可以私信公众号新潮看世界获取
11-25 1095
`${PDAL_ARBITER_LIB_NAME}`：PDAL Arbitrer 库的名称。- `${PDAL_KAZHDAN_LIB_NAME}`：PDAL Kazhdan 库的名称。- `${PDAL_LAZPERF_LIB_NAME}`：PDAL Lazperf 库的名称。- `${CMAKE_DL_LIBS}`：CMake 提供的用于动态加载库文件的库文件。- `${PDAL_LEPCC_LIB_NAME}`：PDAL Lepcc 库的名称。
CMake入门教程【核心篇】链接库(target_link_libraries)
小鱼酱的博客
01-02 3867
CMake链接库(target_link_libraries)
cmake target_link_libraries 中的PRIVATE, PUBLIC, INTERFACE 详解
znsoft的专栏
07-23 1万+
网上关于 target_link_libraries 中的 PRIVATE, PUBLIC , INTERFACE 的解释大部分是错的，而且不是一般的错，是胡说。 因为这三个属性在不同的命令中使用时意义不同，有很多是从target_include_libraries中抄来的。 下面是target_link_libraries中的解释 Link Inheritance Similarly, for anytarget, in the linking stage, we would need ..
【CMake】target_link_libraries() 命令详解-指定链接库文件
weixin_43510208的博客
06-14 1407
它定义了目标（如可执行文件或库）需要链接哪些库文件，并控制依赖关系的传播（通过。CMake 会按依赖关系自动调整库的链接顺序。的传播特性，可大幅简化复杂项目的依赖管理！避免省略关键字，明确依赖范围。是 CMake 中用于。：先声明目标，再调用。），而非直接写路径。
CMake4-指令3-1：target_link_libraries（链接库）【声明链接时需要参与的依赖库（例如可执行文件或其他库）】【三种链接范围：PRIVATE、PUBLIC、INTERFACE】
u013250861的博客
11-20 8284
注意：由于一个target中包含多个属性，一般情况下包含了头文件路径。所以使用target作为参数传入此函数时，无需调用。命名的必须是由add_executable()或add_library()之类的命令创建的。：该函数声明了链接时需要参与的依赖库名称或target。其名称可包含完整路径。再次声明添加头文件路径。
[cmake]target_link_libraries参数：PRIVATE、PUBLIC、INTERFACE三者区别
玄冬Wong
04-30 4825
  原文： CMake target_link_libraries Interface Dependencies http://stackoverflow.com/questions/26037954/cmake-target-link-libraries-interface-dependencies     If you are creating a shared library...
CMake6-跨平台编译特性设置1-构建参数1：target_include_directories、target_link_libraries、target_compile_definitions
u013250861的博客
06-06 155
【代码】CMake-5-跨平台编译特性设置1-构建参数1：target_include_directories【包含目录】、target_link_libraries【导入依赖库】
【cmake】CMakeList添加库|添加头文件|添加路径|add_executable、add_library、target_link_libraries|添加编译选项|宏开关...
小鱼菜鸟的博客
07-22 8103
目录 官网查阅 开胃菜例子 CMakeLists生成和添加依赖库 CMakeLists更多小例子 生成.so共享库文件 调用.so共享库文件 生成一个可执行程序的 CMakeList 生成一个.so动态库的 CMakeList add_library(生成库)，target_link_libraries(生成目标连接的库)，set_t...
[cmake]cmake编译命令target_compile_definitions简介
FL1768317420的博客
03-27 3906
在编译main可执行文件时候，使用了-DDEBUG_PRINT -DINTERFACE_TEST_DEF -DPUBLIC_PRINT ，说明test库的PUBLIC和INTERFACE预编译选项传递给了main。1、对于CMakeLists.txt，通过构建一个test库和一个可执行文件main，对test库添加3个编译选项：一个是范围为PRIVATE的PRIVATE_PRINT，一个是范围为PUBLIC的PUBLIC_PRINT，一个范围是INTERFACE的INTERFACE_TEST_DEF；
CMake中的PUBLIC、PRIVATE 和 INTERFACE用法
我的博客
09-21 846
PRIVATE：只对目标自身生效，不传播。PUBLIC：对目标自身和依赖目标都生效。INTERFACE：对目标自身不生效，但传播给依赖目标。在命令中，PUBLICPRIVATE和INTERFACE这三个选项并不是必须的。如果你没有指定这三个选项中的任何一个，CMake会默认使用PRIVATE。PUBLIC：链接的库及其包含目录和编译选项对目标及其依赖项可见。PRIVATE：链接的库及其包含目录和编译选项仅对目标可见，不对依赖项可见。INTERFACE。
target_link_libraries和target_include_directories参数PUBLIC，PRIVATE，INTERFACE详解
键盘的起始页
10-28 1万+
1. 指令说明 target_include_directories()：指定目标包含的头文件路径。官方文档 target_link_libraries()：指定目标链接的库。官方文档 target_compile_options()：指定目标的编译选项。官方文档 目标由add_library()或add_executable()生成。 这三个指令类似，这里以target_include_directories()为例进行讲解。 2. 指令讲解 测试工程目录结构： cmake...
CMake中target_link_libraries的使用
热门推荐
网络资源是无限的
12-03 6万+
CMake中target_link_libraries的使用
CMake系列讲解（入门篇）1.7 基础命令CMake-target_link_libraries()
在下马农的碎碎念
09-27 1万+
camke camke isntall cmake find_package cmake target_link_libraries target_link_libraries是一个CMake构建系统中的命令，用于指定链接目标文件时所需的库文件。该命令允许开发者在构建过程中将所需的库文件与目标文件进行关联，以确保在编译和链接阶段正确地解析和链接依赖项。
cmake target_link_libraries() 中<PUBLIC|PRIVATE|INTERFACE> 的区别
weixin_30929011的博客
08-16 981
如果目标的头文件中包含了依赖的头文件(源文件间接包含)，那么这里就是PUBLIC 如果目标仅源文件中包含了依赖的头文件，那么这里就是PRIVATE 如果目标的头文件包含依赖，但源文件未包含，那么这里就是INTERFACE https://cmake.org/cmake/help/v3.0/manual/cmake-buildsystem.7.html#transitive-usage...
【CMake中的链接权限详解 】深入理解CMake中PRIVATE、PUBLIC与INTERFACE的链接
探索C++编程的奥秘，分享深入的技术见解和实践，旨在激发读者创造力与解决问题的思维。
10-25 985
【CMake中的链接权限详解 】深入理解CMake中PRIVATE、PUBLIC与INTERFACE的链接
target_link_libraries(<target> <PRIVATE|PUBLIC|INTERFACE> <lib>...)
stanwayll的博客
05-24 3771
target_link_libraries( ... [PRIVATE|PUBLIC|INTERFACE> ...] ...]) 作用： PUBLIC，PRIVATE和INTERFACE关键字能够实现在一条命令中同时指定链接依赖和链接接口。 参数： 1.若使用PUBLIC，库文件和目标文件会被链接到接口并成为它的一部分。 2.若使用PRIVATE，库文件和目标文件只会被链接到接口但不会
【Cmake】在cmakeList中给unit test cpp文件link library时不加public/private的原因
qq_40145095的博客
08-07 406
单元测试通常是在测试目标（test target）中链接测试框架和被测代码，这些库只需要在测试目标中可用，而不需要传递到其他目标。这意味着链接的库将只会影响当前目标，而不会传递到依赖于当前目标的其他目标。关键字，CMake 可能会报告链接错误，因为测试框架和被测代码库的符号可能会冲突或导致其他问题。这是因为测试目标通常只需要私有地链接到测试框架和被测代码，不需要将这些依赖传递给其他目标。总之，默认情况下，如果没有显式地指定链接类型，CMake 会将库的链接默认视为。所以，在单元测试的情况下，如果在。
#Cmake#__target_link_libraries函数的使用说明
sinat_37231928的博客
12-02 4万+
#Cmake#__target_link_libraries函数的使用说明参数声明常用方式作用域说明 参数声明 target_link_libraries：为target连接库的头文件路径（被link库生成CMakeLists.txt中定义的头文件路径）和对应定义的函数库路径 target_link_libraries(<target> <PRIVATE|PUBLIC|INTERFACE> <item>...
target_link_libraries默认值 PRIVATE vs PUBLIC vs INTERFACE
最新发布
07-12
<think>我们正在讨论CMake中的`target_link_libraries`命令，特别是链接作用域选项（PRIVATE, PUBLIC, INTERFACE）的区别以及默认值。 根据引用[1]：当不明确指定链接类型（public、private 或 interface）时，CMake 默认使用 PRIVATE 链接类型。 引用[2]提供了命令的格式：`target_link_libraries(targetName <PRIVATE|PUBLIC|INTERFACE> item1 ...)` 现在，我们详细解释这三个作用域的区别： 1. **PRIVATE**：表示依赖项仅用于构建当前目标（target），不会传递给依赖当前目标的其他目标。即，链接的库仅用于当前目标的实现，不会暴露给使用该目标的其他目标。 例如（引用[4]）：在构建`hello-world`库时，如果只在源文件（如`hello_world.c`）中使用了某个库（如`hello`），而在公开头文件（`hello_world.h`）中未使用，且使用`hello-world`库的其他目标（如`main`）不需要知道`hello`库的存在，则使用PRIVATE。 2. **INTERFACE**：表示依赖项不会用于构建当前目标，但会传递给依赖当前目标的其他目标。即，当前目标本身不使用该库，但使用当前目标的其他目标需要链接该库。 例如：如果当前目标是一个头文件库（没有源文件，只有头文件），那么它可能要求使用它的目标链接某些库，这时就可以用INTERFACE。 3. **PUBLIC**：是PRIVATE和INTERFACE的组合。表示依赖项既用于构建当前目标，也会传递给依赖当前目标的其他目标。即，当前目标在实现中使用该库，并且其头文件也使用了该库（因此使用当前目标的其他目标也需要该库）。 例如（引用[3]）：在构建`hello-world`库时，如果源文件（`hello_world.c`）和公开头文件（`hello_world.h`）都使用了`hello`库，并且使用`hello-world`库的`main`也需要使用`hello`库的功能，则使用PUBLIC。 总结： - **PRIVATE**：仅构建当前目标时使用。 - **INTERFACE**：仅用于依赖当前目标的目标（当前目标自身不使用）。 - **PUBLIC**：既用于构建当前目标，也用于依赖当前目标的目标。 另外，引用[5]提到了一些CMake变量，但这个问题主要关注链接作用域，所以这里不展开。 **默认值**：如果不指定作用域，则默认为PRIVATE（引用[1]）。 因此，在编写CMakeLists.txt时，应根据目标之间的依赖关系选择合适的作用域，以确保依赖关系正确传递，避免链接错误或过度暴露依赖。 §§相关问题§§ 1. 在CMake中，除了`target_link_libraries`，还有哪些命令可以使用PRIVATE、PUBLIC、INTERFACE作用域？ 2. 如何正确使用`target_include_directories`命令的作用域选项？ 3. 在大型项目中，如何管理CMake目标之间的依赖关系以避免循环依赖？ 4. CMake中的目标属性（如INCLUDE_DIRECTORIES、LINK_LIBRARIES）是如何被作用域选项影响的？</think>### CMake中`target_link_libraries`的作用域选项详解 在CMake中，`target_link_libraries`命令用于指定目标（可执行文件或库）的链接依赖关系，其作用域选项（`PRIVATE`、`PUBLIC`、`INTERFACE`）控制依赖项的传递性： #### 1. **默认作用域：`PRIVATE`** - 当未显式指定作用域时（如`target_link_libraries(my_target libA)`），CMake默认使用`PRIVATE`[^1]。 - **行为**：依赖项`libA`仅用于构建`my_target`，**不会**传递给链接`my_target`的其他目标。 - **适用场景**：依赖项仅在当前目标的源文件中使用，且不暴露给外部调用者。 ```cmake # 示例：libA仅在my_target.c中使用，外部无需感知 target_link_libraries(my_target PRIVATE libA) # 默认可省略PRIVATE ``` #### 2. **作用域区别** | 作用域 | 当前目标是否使用依赖 | 依赖是否传递给下游目标 | 典型场景 | |-------------|----------------------|------------------------|--------------------------------------------------------------------------| | `PRIVATE` | ✔️ | ❌ | 依赖仅用于实现内部逻辑（如`.c`文件使用）[^4] | | `INTERFACE` | ❌ | ✔️ | 依赖仅通过头文件暴露给下游（如头文件库）[^3] | | `PUBLIC` | ✔️ | ✔️ | 依赖同时用于内部实现和对外接口（如头文件+源文件均使用依赖）[^3] | #### 3. **关键差异示例 - **`PUBLIC` vs `PRIVATE`**： ```cmake # 若my_target.h中声明了libB的函数，my_target.c中实现了该函数 target_link_libraries(my_target PUBLIC libB) # 下游链接my_target时自动获得libB ``` ```cmake # 若libC仅在my_target.c内部使用 target_link_libraries(my_target PRIVATE libC) # 下游无需知道libC存在[^4] ``` - **`INTERFACE`**： ```cmake # 头文件库：my_header_lib.h直接包含libD的头文件 target_link_libraries(my_header_lib INTERFACE libD) # 下游链接时需libD[^3] ``` #### 4. **作用域对包含路径的影响** 作用域选项同样适用于`target_include_directories`： ```cmake # 下游目标需包含libE的头文件 target_include_directories(my_target PUBLIC path/to/libE/include) ``` > ⚠️ **错误使用后果** > 误用`PRIVATE`可能导致下游目标链接失败（缺少依赖）；误用`PUBLIC`可能导致依赖过度暴露，增加编译耦合性[^2][^3]。 ---
评论 5
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值