CMake安装后怎么生成静态库?

风瑶姑娘_8596

风瑶姑娘_8596

2026-08-08

782人浏览

原创

add_library必须显式指定static才能生成静态库,否则默认创建interface目标或报错;install需配合archive destination安装归档文件,并同步安装头文件。

cmake安装后怎么生成静态库?

add_library 里必须写 STATIC

生成静态库不是靠 install 或 make install 完成的,而是靠 add_library 命令指定类型。漏掉 STATIC 关键字,CMake 默认会建一个 INTERFACE 库(无文件产出)或报错,根本不会生成 .a 或 .lib 文件。

  • add_library(mylib STATIC src/a.cpp src/b.cpp) → 正确,输出 libmylib.a(Linux/macOS)或 mylib.lib(Windows)
  • add_library(mylib src/a.cpp src/b.cpp) → 错误,CMake 报错或静默创建 INTERFACE 目标,build/ 下找不到归档文件
  • 即使后续加了 install(TARGETS mylib ARCHIVE DESTINATION lib),目标本身没声明为 STATIC,install 就没东西可装

ARCHIVE_OUTPUT_DIRECTORY 决定 .a/.lib 放哪

静态库文件默认输出到 CMAKE_BINARY_DIR 下的 lib/ 子目录(Linux/macOS)或 Release/ 等配置子目录(Windows MSVC),但位置不直观。用 set_target_properties 显式设 ARCHIVE_OUTPUT_DIRECTORY 更可靠:

C++14
C++14

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

下载
  • set_target_properties(mylib PROPERTIES ARCHIVE_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/lib")
  • 注意:只对 STATIC 目标生效;SHARED 目标对应 LIBRARY_OUTPUT_DIRECTORY,EXECUTABLE 对应 RUNTIME_OUTPUT_DIRECTORY
  • 路径建议用 ${CMAKE_BINARY_DIR} 而非 ${CMAKE_SOURCE_DIR},避免污染源码树

install(TARGETS ...) 必须带 ARCHIVE DESTINATION

运行 cmake --install 时,如果没在 install(TARGETS ...) 中声明 ARCHIVE DESTINATION,静态库不会被复制到安装目录,哪怕它已在 build 目录生成。

  • 正确写法:install(TARGETS mylib ARCHIVE DESTINATION lib)
  • 错误写法:install(TARGETS mylib) → 静态库被忽略,install 后 prefix/lib/ 下空空如也
  • ARCHIVE 是静态库专属关键字,不能用 LIBRARY(那是给 SHARED 的),也不能省略
  • 安装路径是相对于 CMAKE_INSTALL_PREFIX 的,比如 CMAKE_INSTALL_PREFIX=/usr/local + DESTINATION lib → 最终路径是 /usr/local/lib/libmylib.a

头文件也要 install,否则别人用不了

只装 .a 文件没用——调用方编译时找不到 #include 的头文件。必须把头文件一并 install(DIRECTORY ...) 或 install(FILES ...):

  • install(DIRECTORY include/ DESTINATION include) → 把整个 include/ 复制到 ${CMAKE_INSTALL_PREFIX}/include/
  • install(FILES include/mylib.h DESTINATION include) → 只装单个头文件
  • 若头文件路径通过 target_include_directories(mylib PUBLIC $<include>)</include> 导出,安装后 CMake 依赖方才能自动找到它
  • 漏装头文件是最常见的“库装了但编译失败”原因,错误信息通常是 fatal error: mylib.h: No such file or directory
实际构建流程里,最容易卡住的其实是头文件路径和 ARCHIVE 关键字的搭配——这两处出错,build 成功但 install 后别人根本链接不了。

相关文章

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

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

下载

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

相关专题

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

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

2025.10.17

6726

15

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

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

2025.10.23

1611

14

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

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

2025.12.13

354

18

Playwright 测试失败怎么办
Playwright 测试失败怎么办

Playwright测试失败专题汇集超时、定位器匹配、浏览器提前关闭、依赖与插件配置、文件上传、SSL及Docker启动等故障文章,并介绍通过截图、报告和Trace定位错误。

2026.10.21

20

15

Playwright 页面操作指南
Playwright 页面操作指南

Playwright页面操作专题汇集元素定位、点击与输入、等待响应、多页面切换、Iframe、事件监听及文件处理的已审核文章,便于按操作场景查阅示例与常见问题。

2026.10.21

0

16

Playwright 入门教程
Playwright 入门教程

Playwright入门专题汇集测试框架安装、VS Code配置、录制脚本、编写首个用例、运行调试及查看报告的已审核文章,帮助初学者搭建端到端测试流程。

2026.10.21

0

16

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

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

2026.10.16

120

10

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

2026.10.16

80

10

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

2026.10.16

60

10

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
LLVM CMake构建指南
LLVM CMake构建指南

共0课时 | 0人学习

LLVM入门手册
LLVM入门手册

共0课时 | 0人学习

CMake 与 Conan 集成实践
CMake 与 Conan 集成实践

共0课时 | 0人学习