CMake新手必看：5分钟搞懂add_library的三种用法（含INTERFACE库避坑指南）

最新推荐文章于 2026-08-21 13:15:23 发布

原创

最新推荐文章于 2026-08-21 13:15:23 发布 · 134 阅读

CMake实战指南：add_library的三种模式深度解析与工程实践

在构建C/C++项目时，CMake作为跨平台构建系统的标准工具，其核心命令add_library的正确使用直接关系到项目的可维护性和扩展性。许多开发者在初次接触CMake时，往往对静态库、共享库和接口库的区别感到困惑，特别是在处理复杂项目依赖关系时容易踩坑。本文将带你从工程实践角度，彻底掌握这三种库类型的创建方法和适用场景。

1. 基础概念：理解CMake中的库类型

CMake中的add_library命令支持创建三种主要类型的库文件，每种类型在构建过程和最终产物上都有显著差异。理解这些差异是正确使用它们的前提。

**静态库(STATIC)**是最传统的库类型，在Linux系统下通常以.a为后缀，Windows下则是.lib。它的核心特点是：

编译时会将库代码直接嵌入到最终的可执行文件中
生成的可执行文件不依赖外部库文件即可运行
适合小型项目或需要简化部署的场景

**共享库(SHARED)**也称为动态库，Linux下为.so文件，Windows下为.dll。它的特点是：

运行时才加载，多个程序可以共享同一份库代码
需要与可执行文件一起部署
适合大型项目或需要热更新的场景

**接口库(INTERFACE)**是CMake特有的概念，它：

不产生任何实际的二进制文件
仅用于传递编译选项、头文件路径等构建信息
是现代CMake项目管理依赖关系的推荐方式

这三种库类型的选择需要根据项目规模、部署需求和团队协作方式综合考虑。下面我们通过具体示例来掌握它们的创建方法。

2. 静态库与共享库的创建与使用

2.1 静态库的完整创建流程

创建静态库是CMake中最基础的操作。假设我们有一个数学运算库项目，包含math_operations.cpp和对应的头文件math_operations.h，创建静态库的CMakeLists.txt配置如下：

cmake_minimum_required(VERSION 3.10)
project(MathLibrary)

# 创建静态库
add_library(math_static STATIC 
    src/math_operations.cpp
)

# 设置头文件目录
target_include_directories(math_static
    PUBLIC 
    ${CMAKE_CURRENT_SOURCE_DIR}/include
)

# 设置C++标准
target_compile_features(math_static PUBLIC cxx_std_11)

关键点说明：