无外网环境下CMake替代FetchContent使用本地依赖的方法咨询

一、修改Zlib依赖的CMake代码示例 #

假设你已经将Zlib v1.2.11的仓库克隆到了cmake/dependencies目录下（比如目录名为zlib-1.2.11），只需将原代码中的GIT_REPOSITORY和GIT_TAG替换为SOURCE_DIR参数，指定本地源码路径即可，同时保留原有的补丁命令：

# ##############################################################################
# ZLIB
# ##############################################################################
if(BUILD_ZLIB)
  message(CHECK_START "Using local ZLIB")
  list(APPEND CMAKE_MESSAGE_INDENT "  ")
  FetchContent_Declare(
    zlib
    SOURCE_DIR "${CMAKE_CURRENT_LIST_DIR}/zlib-1.2.11" # 替换为你的本地Zlib实际路径
    PATCH_COMMAND git apply --ignore-whitespace "${CMAKE_CURRENT_LIST_DIR}/../../patches/ZLIB.patch")
  FetchContent_MakeAvailable(zlib)
  list(POP_BACK CMAKE_MESSAGE_INDENT)
  message(CHECK_PASS "loaded")
endif()

注意事项： #

• 确保SOURCE_DIR的路径正确：路径是相对于当前CMakeLists.txt（即cmake/dependencies/CMakeLists.txt）的位置，若Zlib放在该目录下，直接写${CMAKE_CURRENT_LIST_DIR}/zlib即可
• 本地Zlib版本必须与原代码中的GIT_TAG（v1.2.11）一致，避免版本不匹配导致构建错误
• 必须保留PATCH_COMMAND：ORTools对Zlib有定制化补丁，需要应用后才能正常构建

二、FetchContent_Declare能否指向本地目录？ #

可以，使用SOURCE_DIR参数就是CMake官方支持的方式，用来指定本地已存在的源码目录，完全替代通过Git拉取远程仓库的逻辑。当FetchContent_MakeAvailable执行时，会直接使用本地目录的源码，不再尝试联网克隆。

三、其他替代方案 #

如果修改FetchContent的方式不符合你的需求，还有以下几种离线构建的思路：

1. 使用ExternalProject_Add #

这是CMake另一个处理外部依赖的模块，同样支持指定本地源码目录，配置如下（以Zlib为例）：

if(BUILD_ZLIB)
  include(ExternalProject)
  ExternalProject_Add(
    zlib
    SOURCE_DIR "${CMAKE_CURRENT_LIST_DIR}/zlib-1.2.11"
    PATCH_COMMAND git apply --ignore-whitespace "${CMAKE_CURRENT_LIST_DIR}/../../patches/ZLIB.patch"
    CMAKE_ARGS -DCMAKE_INSTALL_PREFIX=${CMAKE_BINARY_DIR}/external/zlib
    BUILD_COMMAND make
    INSTALL_COMMAND make install
  )
  # 手动导入依赖的头文件和库
  include_directories(${CMAKE_BINARY_DIR}/external/zlib/include)
  link_directories(${CMAKE_BINARY_DIR}/external/zlib/lib)
endif()

这种方式需要手动处理依赖的安装和导入，比FetchContent繁琐，但灵活性更高。

2. 预编译依赖库 #

在本地提前编译好Zlib等依赖的静态/动态库，然后在CMake中通过find_package直接链接：

# 设置预编译库的根目录
set(ZLIB_ROOT "/path/to/prebuilt/zlib")
# 查找预编译库
find_package(ZLIB REQUIRED)
# 链接库
target_link_libraries(your_target PRIVATE ZLIB::ZLIB)

这种方式不需要在目标环境构建依赖源码，适合对构建速度要求较高的场景。

3. 添加离线构建开关 #

为了兼顾在线和离线场景，可以在项目根目录的CMakeLists.txt中添加一个选项，动态切换依赖来源：

# 根目录CMakeLists.txt中添加
option(OFFLINE_BUILD "使用本地依赖而非从Git拉取" OFF)

然后在cmake/dependencies/CMakeLists.txt中修改Zlib的逻辑：

if(BUILD_ZLIB)
  message(CHECK_START "${OFFLINE_BUILD ? \"使用本地ZLIB\" : \"拉取ZLIB\"}")
  list(APPEND CMAKE_MESSAGE_INDENT "  ")
  if(OFFLINE_BUILD)
    FetchContent_Declare(
      zlib
      SOURCE_DIR "${CMAKE_CURRENT_LIST_DIR}/zlib-1.2.11"
      PATCH_COMMAND git apply --ignore-whitespace "${CMAKE_CURRENT_LIST_DIR}/../../patches/ZLIB.patch")
  else()
    FetchContent_Declare(
      zlib
      GIT_REPOSITORY "https://github.com/madler/ZLIB.git"
      GIT_TAG "v1.2.11"
      PATCH_COMMAND git apply --ignore-whitespace "${CMAKE_CURRENT_LIST_DIR}/../../patches/ZLIB.patch")
  endif()
  FetchContent_MakeAvailable(zlib)
  list(POP_BACK CMAKE_MESSAGE_INDENT)
  message(CHECK_PASS "${OFFLINE_BUILD ? \"加载完成\" : \"拉取完成\"}")
endif()

构建时通过cmake -DOFFLINE_BUILD=ON ..启用离线模式，无需修改代码即可切换依赖来源。

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