9、条件下载：根据平台、编译选项与构建类型灵活拉取依赖

说实话，CMake 的 FetchContent 用顺手之后，你很快会发现一个现实问题：不是所有依赖在所有环境下都一样。

Windows 上需要一套库，Linux 上可能是另一套。Debug 构建要带符号的版本，Release 构建要优化过的版本。甚至同一个库，因为编译选项不同，拉取的源码分支都不一样。

我刚开始用 FetchContent 做条件下载时，也踩过不少坑。有一次在 macOS 上编译好好的项目，放到 CI 的 Ubuntu 机器上就报找不到头文件——后来才发现，是平台判断写错了。嗯，这种问题排查起来真的很头疼。

今天我们就来聊聊，怎么用 CMake 的条件判断，让 FetchContent 做到「看人下菜碟」。

为什么需要条件下载？

你想想看，一个跨平台项目，依赖的底层库往往有平台差异。比如：

• Windows 上用 WinPcap，Linux 上用 libpcap
• macOS 上用系统自带的 Accelerate 框架，Linux 上用 OpenBLAS
• Debug 构建需要下载带断言检查的版本，Release 构建要性能最优的版本

如果一股脑全下载，不仅浪费带宽，还可能因为平台不兼容导致编译失败。说白了，条件下载不是炫技，是刚需。

根据平台下载不同依赖

CMake 提供了 WIN32、APPLE、UNIX 等内置变量来判断平台。我个人习惯用 CMAKE_SYSTEM_NAME，它更精确，能区分 Linux、Darwin（macOS）、Windows 等。

来看一个实际例子：

# 根据平台选择不同的网络库
if(WIN32)
  FetchContent_Declare(
    network_lib
    GIT_REPOSITORY https://github.com/example/winpcap.git
    GIT_TAG v4.1.3
  )
elseif(APPLE)
  FetchContent_Declare(
    network_lib
    GIT_REPOSITORY https://github.com/example/libpcap-macos.git
    GIT_TAG v1.10.4
  )
elseif(UNIX)
  FetchContent_Declare(
    network_lib
    GIT_REPOSITORY https://github.com/example/libpcap-linux.git
    GIT_TAG v1.10.4
  )
endif()

FetchContent_MakeAvailable(network_lib)

根据编译选项下载

有些库需要根据编译选项决定下载哪个版本。比如，是否启用 GPU 加速、是否使用静态链接等。

我曾经遇到过一个项目，客户要求必须用静态链接的 OpenSSL。当时我就在 CMake 里加了一个选项：

option(USE_STATIC_OPENSSL "Use static OpenSSL" OFF)

if(USE_STATIC_OPENSSL)
  FetchContent_Declare(
    openssl
    GIT_REPOSITORY https://github.com/openssl/openssl.git
    GIT_TAG OpenSSL_1_1_1-static
  )
else()
  FetchContent_Declare(
    openssl
    GIT_REPOSITORY https://github.com/openssl/openssl.git
    GIT_TAG OpenSSL_1_1_1-shared
  )
endif()

FetchContent_MakeAvailable(openssl)

这里的关键是 option() 命令。它让用户可以在命令行传 -DUSE_STATIC_OPENSSL=ON 来控制下载行为。说白了，就是把选择权交给使用者。

根据构建类型下载

Debug 和 Release 构建，依赖的库可能完全不同。比如：

• Debug 需要带调试符号的版本
• Release 需要优化过的版本
• 有些库 Debug 和 Release 的 ABI 不兼容

CMake 的 CMAKE_BUILD_TYPE 变量就是干这个用的：

if(CMAKE_BUILD_TYPE STREQUAL "Debug")
  FetchContent_Declare(
    my_logger
    GIT_REPOSITORY https://github.com/example/logger.git
    GIT_TAG debug-v2.0
  )
else()
  FetchContent_Declare(
    my_logger
    GIT_REPOSITORY https://github.com/example/logger.git
    GIT_TAG release-v2.0
  )
endif()

FetchContent_MakeAvailable(my_logger)

组合条件：平台 + 构建类型

实际项目中，条件往往是组合的。比如：Windows 上 Debug 构建用一套，Linux 上 Release 构建用另一套。

我一般这样写：

# 组合条件判断
if(WIN32 AND CMAKE_BUILD_TYPE STREQUAL "Debug")
  set(MY_LIB_TAG "win-debug-v1.0")
elseif(WIN32 AND CMAKE_BUILD_TYPE STREQUAL "Release")
  set(MY_LIB_TAG "win-release-v1.0")
elseif(APPLE AND CMAKE_BUILD_TYPE STREQUAL "Debug")
  set(MY_LIB_TAG "mac-debug-v1.0")
else()
  set(MY_LIB_TAG "linux-release-v1.0")
endif()

FetchContent_Declare(
  my_lib
  GIT_REPOSITORY https://github.com/example/my_lib.git
  GIT_TAG ${MY_LIB_TAG}
)

FetchContent_MakeAvailable(my_lib)

这样写的好处是，所有条件集中在一个地方，后面 FetchContent 的调用非常干净。你想想看，如果每个 FetchContent_Declare 里都写一堆 if-else，代码会变得多臃肿？

用 SVG 梳理一下逻辑

下面这张图，把条件下载的三种场景和判断流程画清楚了：

避坑指南

最后分享几个我踩过的坑：

• 变量作用域问题： 在函数或宏内部设置的条件变量，外部可能访问不到。建议在顶层 CMakeLists.txt 里做条件判断。
• 缓存变量干扰： 如果之前配置过某个 GIT_TAG，CMake 会缓存它。下次改条件后记得清理 CMakeCache.txt，或者用 set(<var> ... CACHE ... FORCE) 强制更新。
• 多配置生成器： 前面提过，Visual Studio 这类生成器在配置阶段 CMAKE_BUILD_TYPE 是空的。这时候可以用 generator expressions 在编译阶段做区分，但 FetchContent 不支持生成器表达式。我的做法是：让 FetchContent 下载通用版本，然后在 target 层面用生成器表达式控制编译选项。

好了，条件下载的内容就聊到这里。记住一句话：让 CMake 替你做判断，别让开发者手动改代码。这才是自动化构建该有的样子。

---