CMakeLists里的add_library怎么用?

轻瑶君_1165

轻瑶君_1165

2026-08-09

401人浏览

原创

add_library默认行为由build_shared_libs决定:on时生成动态库,off时生成静态库;建议显式声明static或shared;头文件可加入源列表以建立依赖但不编译;同名目标不能同时定义static和shared;exclude_from_all使目标不参与默认构建且install需显式声明。

cmakelists里的add_library怎么用?

add_library没加类型参数,结果生成了动态库?

默认行为取决于 BUILD_SHARED_LIBS 变量值:如果它是 ON,add_library(mylib src.cpp) 就生成 .so 或 .dll;如果是 OFF(CMake 默认),才生成静态库。很多人没改这个变量,又没显式写 STATIC,结果在 CI 上编译出动态库,本地却一直是静态的——环境不一致导致链接失败。

建议始终显式声明类型:

  • 要静态库,就写 add_library(mylib STATIC src.cpp)
  • 要动态库,就写 add_library(mylib SHARED src.cpp)
  • 别依赖全局变量,尤其当项目要跨团队、跨平台交付时

头文件要不要放进 add_library 的源文件列表?

可以放,但不是为了“编译”,而是为了建立依赖关系。比如 add_library(mylib STATIC src.cpp include/mylib.h),这样当 mylib.h 被修改,CMake 会触发 mylib 重编译——否则只改头文件,库可能不重建,导致符号不一致或 ODR 错误。

注意两点:

  • .h 文件不会被编译,只是作为依赖项参与构建图
  • 真正让其他目标能 #include 到它的路径,得靠 target_include_directories(mylib PUBLIC include)
  • 别把无关头文件(比如第三方库头)塞进去,会污染依赖判断

同一个名字,想同时生成静态和动态版本?

不能用同一个 target_name,因为 CMake 要求目标名全局唯一。add_library(utils STATIC ...) 和 add_library(utils SHARED ...) 会报错:add_library cannot create target "utils" because another target with the same name already exists。

C++
C++

"空空如也"

下载

正确做法是起不同名字:

  • add_library(utils_static STATIC src/utils.cpp)
  • add_library(utils_shared SHARED src/utils.cpp)
  • 再用 set_target_properties 统一输出名(如都叫 utils),避免下游硬编码文件名
  • 若需自动选择,可用 if(BUILD_SHARED_LIBS) 分支控制,但目标名仍不能重复

EXCLUDE_FROM_ALL 是干啥的,什么时候该用?

加上它,这个库就不会被 make 或 ninja 默认构建——除非别的目标(比如可执行文件)明确依赖它,或者你手动 make mylib。

典型场景:

  • 提供给外部项目使用的 SDK 库,内部构建时不希望每次都编译
  • 测试专用的 mock 库,主构建流程里不需要
  • 正在开发中的实验性模块,还不稳定,先隔离出来

容易忽略的是:一旦用了 EXCLUDE_FROM_ALL,install() 目标也不会自动包含它,必须显式 install(TARGETS mylib ...),否则 install 后目录里根本没有这个库。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
C++ 跨平台开发
C++ 跨平台开发

本专题聚焦 C++ 在跨平台应用与工程构建中的实战应用,系统讲解 CMake 构建系统、跨平台编译配置、第三方库集成、调试技巧、静态与动态链接库管理等核心知识。通过实战案例(如跨平台工具开发、Linux与Windows编译兼容性项目),帮助学习者掌握 从环境配置到完整跨平台构建的开发能力。

2025.10.17

5426

15

c++  cmake用法
c++ cmake用法

本专题整合了c++ cmake用法相关教程,阅读专题下面的文章了解更多详细内容。

2025.10.23

1411

14

C++ 编译构建系统与CMake实战
C++ 编译构建系统与CMake实战

本专题聚焦 C++ 项目的编译与构建体系,系统讲解 CMake 的核心语法、项目结构设计、库与依赖管理、跨平台构建、调试与发布配置。通过完整项目示例,帮助开发者掌握 从源码到可执行程序的工程化构建流程,提升 C++ 项目在实际开发中的可维护性与扩展性。

2025.12.13

334

18

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

2026.09.23

20

15

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

2026.09.23

0

15

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

2026.09.23

0

15

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

2026.09.22

0

12

Conan二进制包配置指南
Conan二进制包配置指南

本专题介绍Conan根据操作系统、编译器、架构和构建类型生成二进制包的方法,讲解Profile、Settings、Options及Package ID的作用,帮助管理不同平台和编译环境下的包版本。

2026.09.22

20

13

Conan私有仓库搭建教程
Conan私有仓库搭建教程

本专题系统的讲解Conan私有仓库的搭建流程,涵盖仓库服务部署、存储目录配置、用户认证、权限划分和远程地址添加,并介绍内部C++依赖包的上传、下载及版本维护方法。

2026.09.22

0

19

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习

Conan 2 入门教程
Conan 2 入门教程

共0课时 | 0人学习

CLion CMake 快速入门教程
CLion CMake 快速入门教程

共0课时 | 0人学习