CMake项目中解决内部第三方库依赖：libzip与zlib

最优方案1：手动传递zlib的CMake变量（适合已有本地zlib子目录） #

当你通过add_subdirectory(zlib)引入zlib后，zlib的CMake脚本会自动生成ZLIB::ZLIB目标，并设置ZLIB_INCLUDE_DIR、ZLIB_VERSION_STRING等内部变量。只需在引入libzip之前，手动把这些变量提升为全局变量，让libzip的find_package(ZLIB)直接复用：

# 先引入本地zlib子目录
add_subdirectory(zlib)

# 手动设置libzip find_package所需的全局变量
set(ZLIB_FOUND TRUE)
set(ZLIB_INCLUDE_DIRS ${ZLIB_INCLUDE_DIR})
set(ZLIB_LIBRARIES ZLIB::ZLIB)
set(ZLIB_VERSION ${ZLIB_VERSION_STRING})

# 再引入libzip（无论是add_subdirectory还是FetchContent）
add_subdirectory(libzip)

这样libzip的find_package(ZLIB REQUIRED)会直接使用你已经构建的zlib，不会再去系统搜索。

最优方案2：用FetchContent统一管理依赖（跨平台友好） #

如果不想手动维护本地子目录，用CMake的FetchContent模块自动拉取并构建zlib和libzip，同时强制libzip使用我们预先构建的zlib：

include(FetchContent)

# 拉取并构建zlib
FetchContent_Declare(
  zlib
  URL file://${CMAKE_CURRENT_SOURCE_DIR}/zlib-1.3.1 # 本地路径或官方下载链接
  URL_HASH SHA256=91844808532e5ce316b3c010929493c0244f3d37593afd6de04f71821d5136d9
)
FetchContent_MakeAvailable(zlib)

# 配置libzip，禁用它自动拉取zlib的行为
set(LIBZIP_FETCH_ZLIB OFF CACHE BOOL "禁止libzip自行拉取zlib" FORCE)

# 拉取并构建libzip
FetchContent_Declare(
  libzip
  URL file://${CMAKE_CURRENT_SOURCE_DIR}/libzip-1.10.1 # 本地路径或官方下载链接
  URL_HASH SHA256=... # 替换为对应版本的SHA256哈希
)
FetchContent_MakeAvailable(libzip)

其他方案的问题说明 #

• 设置ZLIB_ROOT：zlib源码目录没有预构建的include/lib结构，find_package的模块模式无法识别未编译的源码，因此无效。
• 自行编写libzip的CMakeLists.txt：维护成本极高，每次libzip版本更新都需要同步修改，完全没必要。
• 自定义Findzlib.cmake：zlib官方已经提供完善的CMake支持，自定义脚本反而会破坏跨平台兼容性（比如*nix下无法自动使用系统zlib）。

跨平台兼容补充 #

如果需要同时支持Windows（用本地zlib）和*nix（用系统zlib），可以加条件判断：

if(WIN32)
  add_subdirectory(zlib)
  # 手动设置变量（同方案1）
  set(ZLIB_FOUND TRUE)
  set(ZLIB_INCLUDE_DIRS ${ZLIB_INCLUDE_DIR})
  set(ZLIB_LIBRARIES ZLIB::ZLIB)
  set(ZLIB_VERSION ${ZLIB_VERSION_STRING})
else()
  # *nix下直接用系统zlib
  find_package(ZLIB REQUIRED)
endif()

# 引入libzip
add_subdirectory(libzip)

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