讲师中心 微信公众号
AI工具推荐 视频效率加速

C++如何利用CMake的Object Libraries优化大型项目的编译依赖?(构建系统)

梦芳小哥_5516

梦芳小哥_5516

发布时间:2026-03-02 14:49:02

|

630人浏览过

|

来源于php中文网

原创

能,OBJECT_LIBRARY通过预编译共享对象文件减少重复编译,但仅在多目标共用相同源码且正确引用时有效;改头文件仍会触发整个object library重编译。

c++如何利用cmake的object libraries优化大型项目的编译依赖?(构建系统)

什么是 OBJECT_LIBRARY,它真能减少重编译吗?

能,但只在特定结构下有效——它把源码编译成中间对象文件(.o 或 .obj),不打包成静态库,也不生成符号表,因此不会触发下游目标的全量重链接。关键在于:它让多个可执行目标或库共享同一组预编译对象,避免重复编译相同源码。

常见错误现象:add_library(myobj OBJECT src/a.cpp src/b.cpp) 写对了,但后续 target_sources(exe1 PRIVATE $<TARGET_OBJECTS:myobj>) 漏掉 PRIVATE 或路径拼错,导致对象没被实际引用,白忙一场。

使用场景:

  • 多个测试可执行文件共用同一套工具函数和 fixture 类(比如 test_utils.cpp + mock_network.cpp)
  • 主程序和插件模块共享核心解析逻辑,但插件需独立加载
  • 跨平台项目中,把平台无关逻辑抽为 object library,再按需链接进 Windows DLL / Linux SO

target_sources() 引用 object library 时为什么总报 “unknown target”?

因为 $<TARGET_OBJECTS:xxx> 是生成器表达式,只能用在支持该语法的命令里,最典型的是 target_sources() 和 target_link_libraries()(后者仅限 CMake 3.12+ 且仅用于链接时传递依赖,不推荐)。如果写在 add_executable() 的源码列表里,CMake 会直接报错说找不到 target。

立即学习“C++免费学习笔记(深入)”;

正确做法:

  • 必须先定义 add_library(myobj OBJECT ...),且名字不能含 :: 或空格
  • 引用时严格用 target_sources(myexe PRIVATE $<TARGET_OBJECTS:myobj>),不能写成 target_sources(myexe PRIVATE myobj)
  • 如果 object library 本身依赖其他库(比如用了 fmt::fmt),得用 target_link_libraries(myobj PRIVATE fmt::fmt),否则下游链接时报 undefined reference

参数差异:PRIVATE 表示只影响当前目标,不会把 myobj 的头文件路径或编译定义透传给依赖它的其他目标——这点和静态库不同,得手动补 target_include_directories()。

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载

用 OBJECT_LIBRARY 后,修改头文件还会触发重编译吗?

会,而且可能比想象中更频繁。object library 本身不管理头文件依赖,CMake 只根据源文件时间戳决定是否重编译对象;一旦你改了被 myobj 中某个 .cpp 包含的头文件(比如 common.h),整个 myobj 所有对象都会重编译——哪怕只有 1 个 .cpp 实际用到了这个头文件。

性能影响:

  • 优势:避免多目标重复编译同一份 .cpp,尤其适合 CI 上并行构建多个测试二进制
  • 代价:失去细粒度增量编译能力;若 object library 包含 20 个源文件,改一个头文件就 recompile 20 个对象
  • 兼容性:CMake 3.12+ 才完全支持 $<TARGET_OBJECTS:...> 在 target_sources() 中展开;旧版本只能靠 file(GLOB ...) 手动收集 .o,不可靠

建议搭配 set_property(TARGET myobj PROPERTY POSITION_INDEPENDENT_CODE ON),否则在链接成 shared library 时可能报 relocation R_X86_64_32 错误。

为什么有时候加了 OBJECT_LIBRARY 反而编译变慢了?

最常踩的坑是把它当“万能去重工具”滥用:把几十个业务模块的源码全塞进一个大 object library,结果每次改任意一个头文件,所有模块的对象都得重编。CMake 不会自动分析头文件包含图,也不会跳过未受影响的对象。

真正有效的切分方式:

  • 按变更频率分组:稳定的基础工具类一组,高频迭代的协议解析一组
  • 按头文件作用域隔离:确保 obj_group_a 的头文件不会被 obj_group_b 的源文件 #include
  • 避免跨 object library 的头文件循环依赖,否则 CMake 可能静默忽略某些依赖声明

还有一个隐蔽问题:IDE(如 CLion、VS)对 OBJECT_LIBRARY 的索引支持弱,跳转定义、重命名可能失效——这不是 CMake 的问题,但会影响日常开发体验。

复杂点在于,它不改变头文件依赖的本质,只是把“编译动作”的粒度从文件级挪到了 object library 级。想靠它解决头文件爆炸问题,得先理清 include 树,否则只是把麻烦延后了。

热门AI工具

更多
Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

相关专题

更多
undefined是什么
undefined是什么

undefined是代表一个值或变量不存在或未定义的状态。它可以作为默认值来判断一个变量是否已经被赋值,也可以用于设置默认参数值。尽管在不同的编程语言中,undefined可能具有不同的含义和用法,但理解undefined的概念可以帮助我们更好地理解和编写程序。本专题为大家提供undefined相关的各种文章、以及下载和课程。

11705

2023.07.31

网页undefined是什么意思
网页undefined是什么意思

网页undefined是指页面出现了未知错误的意思,提示undefined一般是在开发网站的时候定义不正确或是转换不正确,或是找不到定义才会提示undefined未定义这个错误。想了解更多的相关内容,可以阅读本专题下面的文章。

5507

2024.08.14

网页undefined啥意思
网页undefined啥意思

本专题整合了undefined相关内容,阅读下面的文章了解更多详细内容。后续继续更新。

2516

2025.12.25

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3239

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2798

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

1488

2023.08.01

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

2579

2023.08.02

windows无法访问共享电脑
windows无法访问共享电脑

在现代社会中,共享电脑是办公室和家庭的重要组成部分。然而,有时我们可能会遇到Windows无法访问共享电脑的问题。这个问题可能会导致数据无法共享,影响工作和生活的正常进行。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

3290

2023.08.08

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

80

2026.10.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn