CMake FetchContent引入LibArchive：无法禁用测试且链接失败问题排查

核心问题分析 #

• 测试无法禁用：直接在FetchContent_Declare前set(ENABLE_TEST OFF)不会传递到libarchive的CMake配置上下文，子项目有独立的变量作用域，导致配置参数不生效。
• Windows下需手动设宏：libarchive的CMake原本会自动检测系统/编译器特性，但FetchContent集成时可能因环境配置不全或检测逻辑未触发，导致需要手动补全宏定义。
• 链接失败：大概率是链接了错误的目标，或是测试编译产生的冗余依赖干扰了主项目的链接流程。

修正后的CMake配置 #

# 配置全局编译标准，确保libarchive能正确检测编译器特性（针对Windows环境）
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 声明LibArchive依赖，通过CMAKE_ARGS直接传递子项目配置参数
FetchContent_Declare(libarchive
  GIT_REPOSITORY https://github.com/libarchive/libarchive/
  GIT_TAG v3.7.4
  CMAKE_ARGS
    # 彻底禁用所有测试相关组件
    -DENABLE_TEST=OFF
    -DENABLE_TEST_SHARED=OFF
    # 关闭非必要的工具、示例和文档
    -DENABLE_EXAMPLES=OFF
    -DENABLE_DOCUMENTATION=OFF
    -DENABLE_TAR=OFF
    -DENABLE_CPIO=OFF
    # 让libarchive自动处理Windows Unicode相关函数，无需手动设宏
    -DENABLE_WINDOWS_UNICODE=ON
)

# 触发依赖拉取与配置，确保传递的参数生效
FetchContent_MakeAvailable(libarchive)

# 链接libarchive导出的正式目标（注意是`archive`而非`libarchive`）
target_link_libraries(myLib PRIVATE archive)

关键调整说明 #

• 通过CMAKE_ARGS传递参数：直接在FetchContent_Declare中指定子项目的CMake配置参数，确保这些变量进入libarchive的配置上下文，彻底禁用测试等冗余组件。
• 启用Windows Unicode支持：ENABLE_WINDOWS_UNICODE=ON会让libarchive自动检测并配置Windows下的宽字符函数，无需手动设置HAVE_WCSCPY这类宏。
• 链接正确目标：libarchive的CMakeLists.txt导出的正式目标名称是archive，之前的libarchive是错误的目标名，这是链接失败的核心原因之一。
• 指定C++标准：明确编译器标准可避免因版本过低导致的特性检测失败，减少手动补宏的需求。

额外排查点 #

如果仍有测试编译残留：

• 清理CMake缓存后重新构建，避免旧配置干扰。
• 若v3.7.4版本对ENABLE_TEST支持不佳，可尝试添加-DBUILD_TESTING=OFF（部分旧版本用此参数控制测试）。

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