CMake 接入第三方库的三种方式：add_subdirectory、FetchContent 与 find_package（C++ 工程入门第六课）

本系列为《CMake 工程化进阶》完整 8 篇体系。
本篇目标：掌握 CMake 中接入第三方库的三种常见方式。

在真实 C++ 工程中，我们几乎不可能只写自己的代码。

常见情况包括：

• 日志库（spdlog）
• 格式化库（fmt）
• JSON 解析（nlohmann/json）
• 网络库（boost / asio）

问题来了：

如何把这些库接入到 CMake 工程？

CMake 提供了三种主流方式：

这一课我们逐一讲清。

一、方式一：add_subdirectory（源码方式）

这种方式最简单。

适合：

第三方库源码直接放在项目中。

示例工程结构

MyApp/ app/ main.cpp util/ util.cpp util.h third_party/ fmt/ CMakeLists.txt

引入第三方库

add_subdirectory(third_party/fmt)

这会：

• 编译 fmt
• 生成 target

链接库

target_link_libraries(app fmt::fmt)

现在 app 就可以使用 fmt。

使用 fmt

#include <fmt/core.h> int main() { fmt::print("Hello {}\n", "CMake"); }

二、方式二：FetchContent（现代主流）

现代 CMake 更推荐这种方式。

优点：

• 自动下载
• 自动编译
• 不需要手动管理源码

引入模块

include(FetchContent)

下载库

FetchContent_Declare( fmt GIT_REPOSITORY https://github.com/fmtlib/fmt.git GIT_TAG 10.1.1 )

自动构建

FetchContent_MakeAvailable(fmt)

链接库

target_link_libraries(app fmt::fmt)

优点

FetchContent 解决了很多问题：

• 不需要手动下载源码
• CMake 自动管理依赖
• 适合开源项目

三、方式三：find_package（系统库）

这种方式适合：

已经安装到系统中的库。

例如：

• OpenCV
• Boost
• Qt

示例

find_package(OpenCV REQUIRED)

链接库

target_link_libraries(app ${OpenCV_LIBS})

示例代码

#include <opencv2/opencv.hpp> int main() { cv::Mat image; }

四、三种方式对比

五、现代 C++ 项目的推荐方式

如果是开源项目：

推荐：

FetchContent

原因：

• 自动化
• 可复现
• 依赖清晰

如果是公司内部项目：

推荐：

add_subdirectory

因为：

• 源码可控
• 构建稳定

六、完整示例 CMakeLists

cmake_minimum_required(VERSION 3.15) project(MyApp) set(CMAKE_CXX_STANDARD 17) include(FetchContent) FetchContent_Declare( fmt GIT_REPOSITORY https://github.com/fmtlib/fmt.git GIT_TAG 10.1.1 ) FetchContent_MakeAvailable(fmt) add_executable(app app/main.cpp ) target_link_libraries(app fmt::fmt)

七、本课总结

本课解决了真实工程中最重要的问题之一：

如何接入第三方库。

掌握三种方式：

其中：

FetchContent 是现代 CMake 最常见方案。

下一课预告

下一篇将进入：

Linux 服务项目的工程结构设计

我们会把当前工程升级为：

cmd/
internal/
lib/
third_party/

并搭建一个真正可扩展的 C++ 服务项目骨架。