如何正确配置FetchContent_Declare实现依赖库静态构建

核心问题分析 #

FetchContent传递的配置参数不生效，通常是参数传递时机错误、依赖库有专属配置选项，或是CMAKE_ARGS写法不符合要求导致的。以下针对libcurl和jsoncpp分别给出修正方案。

针对libcurl的正确配置 #

libcurl的静态库构建不能仅依赖BUILD_SHARED_LIBS OFF，它有专属的BUILD_STATIC_LIBS选项，同时要确保BUILD_CURL_EXE明确关闭。正确的FetchContent_Declare写法如下：

FetchContent_Declare(
  libcurl
  GIT_REPOSITORY https://github.com/curl/curl.git
  GIT_TAG curl-8_4_0 # 替换为你需要的版本
  GIT_SHALLOW ON
  CMAKE_ARGS
    -DBUILD_SHARED_LIBS=OFF
    -DBUILD_STATIC_LIBS=ON
    -DBUILD_CURL_EXE=OFF
    -DCURL_USE_SCHANNEL=ON # Windows下用系统SSL，按需调整
    -DCURL_DISABLE_LDAP=ON
)
FetchContent_MakeAvailable(libcurl)

注意：部分旧版本libcurl对BUILD_SHARED_LIBS支持不佳，必须显式设置BUILD_STATIC_LIBS=ON才能强制生成静态库。

针对jsoncpp的正确配置 #

jsoncpp的静态库构建需要配合JSONCPP_STATIC_LIB选项，同时要确保关闭测试的参数传递正确：

FetchContent_Declare(
  jsoncpp
  GIT_REPOSITORY https://github.com/open-source-parsers/jsoncpp.git
  GIT_TAG 1.9.5 # 替换为你需要的版本
  GIT_SHALLOW ON
  CMAKE_ARGS
    -DBUILD_SHARED_LIBS=OFF
    -DJSONCPP_STATIC_LIB=ON
    -DJSONCPP_WITH_TESTS=OFF
    -DJSONCPP_WITH_POST_BUILD_UNITTEST=OFF
    -DJSONCPP_WITH_WARNING_AS_ERROR=OFF # 可选：避免VS下警告转错误问题
)
FetchContent_MakeAvailable(jsoncpp)

说明：jsoncpp内部配置逻辑优先使用JSONCPP_STATIC_LIB开关，仅设置BUILD_SHARED_LIBS可能无法生效，需两者配合。

通用排查技巧 #

• 参数传递时机：所有依赖库的配置参数必须在FetchContent_Declare的CMAKE_ARGS中传递，或在FetchContent_GetProperties之后、FetchContent_Populate之前设置（手动调用Populate时），不能在FetchContent_MakeAvailable之后设置。
• 清理缓存：VS2017的CMake缓存可能残留旧配置，删除项目下的build目录或CMakeCache.txt后重新配置。
• 核对依赖库配置选项：直接查看拉取的依赖库版本的CMakeLists.txt，确认它支持的配置选项名称（部分库选项大小写敏感）。
• 隔离依赖构建环境：若多个依赖存在配置冲突，可设置FETCHCONTENT_BASE_DIR为dependencies下的子目录，让每个依赖的构建环境独立。

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