CMake FetchContent从GitHub引入Boost库的方法及更简便方案

手动枚举所有Boost依赖子模块的方式维护成本很高，升级版本、增减组件时很容易漏配依赖，以下两种跨平台通用方案都可以实现零繁琐配置，自动完成源码拉取、依赖解析、编译链接全流程，支持iOS、macOS、Android、Windows、Linux全平台，不需要系统预装Boost。

方案1：基于Boost官方超级构建的配置（无额外依赖） #

直接使用Boost官方维护的超级仓库，只需要声明你需要使用的具体组件，构建系统会自动解析所有传递依赖、拉取对应子模块源码，不需要手动逐个声明依赖库。
完整最小CMakeLists.txt配置如下：

cmake_minimum_required(VERSION 3.20...3.27)
project(19-boost-file-system CXX)

set(CMAKE_CXX_STANDARD 23)
set(CMAKE_CXX_EXTENSIONS OFF)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_VISIBILITY_PRESET hidden)
set(CMAKE_VISIBILITY_INLINES_HIDDEN ON)

include(FetchContent)
# 声明Boost源码源
FetchContent_Declare(
  Boost
  GIT_REPOSITORY https://github.com/boostorg/boost.git
  GIT_TAG boost-1.79.0
  GIT_SHALLOW TRUE # 浅克隆，大幅降低下载体积
  GIT_PROGRESS TRUE
  CMAKE_ARGS
    # 列出你需要的Boost组件，多个组件用分号分隔，例如 filesystem;regex;json
    -DBOOST_INCLUDE_LIBRARIES=filesystem
    -DBOOST_ENABLE_CMAKE=ON
    -DBUILD_TESTING=OFF # 关闭Boost测试编译，加速构建
)
FetchContent_MakeAvailable(Boost)

add_executable(main_boost main.cxx)
target_link_libraries(main_boost PRIVATE Boost::filesystem)

配置说明：

• 增减Boost组件只需要修改BOOST_INCLUDE_LIBRARIES参数即可，不需要额外调整其他配置，所有传递依赖会被自动识别拉取
• 切换Boost版本仅需修改GIT_TAG的值，所有子模块会自动对齐到对应版本，不会出现子模块版本不兼容的编译错误
• 首次配置时会自动下载所需源码，后续构建会复用本地缓存，不会重复拉取

方案2：轻量单脚本配置（下载速度更快） #

如果觉得官方超级仓库体积偏大，可以使用单文件CMake封装脚本，脚本会直接按需拉取对应组件的独立仓库，不需要下载整个Boost超级仓库元数据，下载速度更快。
使用方式也很简单：

1. 将单文件Boost CMake脚本放入你项目的cmake目录下
2. 在CMakeLists.txt中引入脚本，指定需要的Boost版本和组件即可，示例配置：

cmake_minimum_required(VERSION 3.20)
project(boost-demo CXX)

set(CMAKE_CXX_STANDARD 23)
include(cmake/BoostFetch.cmake)
# 指定版本和需要的组件，自动完成拉取和配置
boost_fetch(VERSION 1.79.0 COMPONENTS filesystem)

add_executable(main_boost main.cxx)
target_link_libraries(main_boost PRIVATE Boost::filesystem)

跨平台编译注意事项 #

• 两种方案都会自动继承你项目的交叉编译配置，编译iOS、Android等平台目标时不需要额外给Boost传特殊参数，不会出现预编译Boost架构不匹配的问题
• 建议开启GIT_SHALLOW选项，避免拉取Boost仓库十余年的全量提交历史，能把首次下载体积从几百MB降到几十MB
• 不需要手动配置include路径、编译宏，链接Boost::xxx目标时所有依赖配置会被自动传递到你的编译目标

内容的提问来源于stack exchange，提问作者leanid.chaika