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

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

风瑶姑娘_8596

风瑶姑娘_8596

发布时间:2026-08-08 10:17:37

|

782人浏览过

|

来源于php中文网

原创

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 $<INSTALL_INTERFACE:include>) 导出,安装后 CMake 依赖方才能自动找到它
  • 漏装头文件是最常见的“库装了但编译失败”原因,错误信息通常是 fatal error: mylib.h: No such file or directory
实际构建流程里,最容易卡住的其实是头文件路径和 ARCHIVE 关键字的搭配——这两处出错,build 成功但 install 后别人根本链接不了。

热门AI工具

更多
UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

咔片AIPPT

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

豆包大模型

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

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

WorkBuddy

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

DeepSeek

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

相关专题

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

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

6746

2025.10.17

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

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

1611

2025.10.23

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

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

354

2025.12.13

剧云故事大纲与分场规划教程
剧云故事大纲与分场规划教程

本专题讲解剧云梗概与多级大纲功能,覆盖全局、分集、分场结构生成,以及主线冲突、剧情节点和场次顺序调整。

0

2026.10.22

VibeKnow PPT讲解视频教程汇总
VibeKnow PPT讲解视频教程汇总

本专题介绍VibeKnow PPT讲解模式的素材准备、旁白生成、页面节奏、画面呈现与导出设置,适合课程和培训场景。

0

2026.10.22

VibeKnow PDF转视频教程合集
VibeKnow PDF转视频教程合集

本专题围绕VibeKnow的PDF转视频功能,讲解文件准备、内容解析、脚本生成、重点可视化及配音字幕检查方法。

0

2026.10.22

二狗PPT模板与视觉设计
二狗PPT模板与视觉设计

本专题介绍二狗PPT的职场模板、主题风格与页面版式,覆盖模板切换、色彩选择、内容匹配和正式汇报场景下的视觉优化方法。

0

2026.10.22

php漏洞修复方法
php漏洞修复方法

PHP漏洞聚合专题,持续整理PHP最新高危漏洞、CVE安全预警、受影响版本、自查命令及修复方案,覆盖PHP-FPM、Docker、Ubuntu与Linux服务器环境,帮助开发者快速完成漏洞排查、版本升级和安全加固。

0

2026.10.22

二狗PPT入门与基础操作
二狗PPT入门与基础操作

本专题整理二狗PPT从官网进入、输入主题、生成大纲到制作成稿的基础操作,帮助新手掌握AI一键生成职场PPT的完整流程。

0

2026.10.22

热门下载

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

精品课程

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

共0课时 | 0人学习

LLVM入门手册
LLVM入门手册

共0课时 | 0人学习

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

共0课时 | 0人学习

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

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