如何通过CMake配置多二进制目录并缓存第三方库构建文件？

当然可以解决这个问题！我之前也被反复下载第三方库的问题烦过，后来通过给ExternalProject_Add指定独立的全局缓存目录完美解决了——这样清理主项目构建目录时，第三方库的下载、构建产物都会被保留，下次构建直接复用。

1. 定义全局缓存路径 #

先在你的主CMakeLists.txt里定义一个固定的缓存目录，既可以放在项目根目录下的隐藏文件夹（方便随项目同步），也可以放在用户目录下的全局缓存（供多个项目复用）：

# 允许用户通过-D参数覆盖路径，比如 cmake .. -DEXTERNALS_CACHE_DIR=~/my_cmake_global_cache
set(EXTERNALS_CACHE_DIR "${CMAKE_CURRENT_LIST_DIR}/.external_cache" CACHE PATH "Directory to cache external projects")
# 自动创建缓存目录（如果不存在）
file(MAKE_DIRECTORY ${EXTERNALS_CACHE_DIR})

2. 给每个ExternalProject配置缓存参数 #

针对每个第三方库，在ExternalProject_Add里显式指定DOWNLOAD_DIR、SOURCE_DIR、BINARY_DIR、INSTALL_DIR这几个核心路径，把它们指向刚才定义的缓存目录：

include(ExternalProject)

# 示例：引入fmt库
ExternalProject_Add(
    fmt_external
    DOWNLOAD_DIR "${EXTERNALS_CACHE_DIR}/fmt/download"  # 下载的压缩包存放处
    SOURCE_DIR "${EXTERNALS_CACHE_DIR}/fmt/source"      # 解压后的源码目录
    BINARY_DIR "${EXTERNALS_CACHE_DIR}/fmt/build"       # 构建产物目录
    INSTALL_DIR "${EXTERNALS_CACHE_DIR}/fmt/install"    # 安装目录
    GIT_REPOSITORY "https://github.com/fmtlib/fmt.git"
    GIT_TAG "9.1.0"  # 固定版本！避免缓存的源码和需求版本不一致
    CMAKE_ARGS
        -DCMAKE_INSTALL_PREFIX=${EXTERNALS_CACHE_DIR}/fmt/install
        -DFMT_TEST=OFF  # 关闭测试加快构建速度
)

# 链接库时从缓存的安装目录查找
find_package(fmt REQUIRED PATHS "${EXTERNALS_CACHE_DIR}/fmt/install")
target_link_libraries(your_project_target PRIVATE fmt::fmt)

3. 进阶：全局默认前缀（更简洁） #

如果有大量第三方库，不想每个都写重复的路径，可以设置CMAKE_EXTERNAL_PROJECTS_DEFAULT_PREFIX变量，让所有ExternalProject_Add默认使用这个前缀目录：

set(CMAKE_EXTERNAL_PROJECTS_DEFAULT_PREFIX ${EXTERNALS_CACHE_DIR})

# 之后无需重复指定路径，CMake会自动在前缀下创建对应子目录
ExternalProject_Add(
    fmt_external
    GIT_REPOSITORY "https://github.com/fmtlib/fmt.git"
    GIT_TAG "9.1.0"
    CMAKE_ARGS
        -DCMAKE_INSTALL_PREFIX=${CMAKE_EXTERNAL_PROJECTS_DEFAULT_PREFIX}/fmt/install
        -DFMT_TEST=OFF
)

关键注意事项 #

• 固定第三方库版本：一定要用具体的tag、commit哈希或指定版本的下载链接，否则缓存的源码可能和当前需求版本不符，导致构建失败。
• 缓存清理方式：如果需要更新某个库，直接删除缓存目录下对应的子文件夹（比如.external_cache/fmt）即可；也可以添加自定义CMake目标批量清理：

  add_custom_target(clean_externals
      COMMAND ${CMAKE_COMMAND} -E remove_directory ${EXTERNALS_CACHE_DIR}
      COMMENT "Cleaning all external project cache files"
  )
  

• 权限问题：如果缓存目录设置在用户目录（如~/cmake_externals），确保有读写权限；若为团队共享目录，需提前配置好权限规则。

内容的提问来源于stack exchange，提问作者dooxe