CMake FetchContent引入依赖时因重复unity目标导致构建失败，同时需统一运行项目及依赖测试用例的最佳实践问询

嘿，这个问题我之前也踩过坑，未命名空间的目标冲突确实是FetchContent集成第三方依赖时的常见痛点，结合你要统一运行所有测试的核心需求，给你几个符合CMake最佳实践的解决方案，按推荐程度排序：

方案一：给依赖的Unity目标打补丁（最直接，完美匹配需求） #

既然两个依赖都是在测试代码里定义了无命名空间的unity目标，我们可以用FetchContent的PATCH功能，给它们的测试CMakeLists.txt打个轻量补丁，给目标加上各自的命名空间，彻底解决冲突问题，同时完全保留依赖的所有测试用例。

具体在你的项目CMakeLists里可以这么写：

include(FetchContent)
include(CTest)

# 处理libzmq的Unity目标命名空间补丁
FetchContent_Declare(
  libzmq
  GIT_REPOSITORY https://github.com/zeromq/libzmq.git
  GIT_TAG 959a133520dfc80d29e83aa7ef762e1d0327f63b
  PATCH_COMMAND sed -i "s/add_library(unity STATIC/add_library(libzmq_unity STATIC/" tests/CMakeLists.txt
  COMMAND sed -i "s/target_link_libraries(.* unity)/target_link_libraries(\\1 libzmq_unity)/" tests/CMakeLists.txt
)

# 处理cJSON的Unity目标命名空间补丁
FetchContent_Declare(
  cjson
  GIT_REPOSITORY https://github.com/DaveGamble/cJSON.git
  GIT_TAG 19ff92da79ee37c81a4cdf1f50a8dd1cbb02e84f
  PATCH_COMMAND sed -i "s/add_library(unity STATIC/add_library(cjson_unity STATIC/" tests/CMakeLists.txt
  COMMAND sed -i "s/target_link_libraries(.* unity)/target_link_libraries(\\1 cjson_unity)/" tests/CMakeLists.txt
)

FetchContent_MakeAvailable(libzmq cjson)

这个方案不需要修改依赖的源码仓库，只是在FetchContent拉取代码后临时修改，既解决了目标冲突，又能让所有测试（项目自身+两个依赖）自动纳入CTest集合，完全符合你用ctest --test-dir build统一运行的需求。

方案二：统一提供全局Unity目标（适合Unity版本兼容的场景） #

如果两个依赖使用的Unity测试库是同一版本，你可以自己在项目中先定义一个带命名空间的Unity目标，然后让两个依赖共享这个全局版本，而不是各自编译自己的Unity。

步骤大概是：

1. 单独用FetchContent拉取Unity库，定义成project::unity目标；
2. 在引入libzmq和cJSON之前，通过CMAKE_PROJECT_INCLUDE_BEFORE设置钩子，让它们的测试CMakeLists优先使用你定义的全局Unity，而非自行创建。

不过这个方案的前提是两个依赖的Unity版本完全兼容，否则可能出现编译问题，灵活性不如方案一。

方案三：用ExternalProject隔离依赖构建（适合不想修改依赖代码的场景） #

如果补丁方案你觉得麻烦，可以考虑用ExternalProject_Add替代FetchContent，每个依赖单独构建，它们的目标会隔离在各自的构建树中，不会产生冲突。但这种方式的缺点是，依赖的测试用例不会自动加入到你的项目CTest集合里，需要你手动导入：

include(ExternalProject)
include(CTest)

# 构建libzmq并启用测试
ExternalProject_Add(
  libzmq
  GIT_REPOSITORY https://github.com/zeromq/libzmq.git
  GIT_TAG 959a133520dfc80d29e83aa7ef762e1d0327f63b
  CMAKE_ARGS -DBUILD_TESTING=ON
  INSTALL_COMMAND ""
)

# 手动导入libzmq的测试用例
ExternalProject_Get_Property(libzmq BINARY_DIR)
add_test(NAME libzmq_cJSON_test COMMAND ${BINARY_DIR}/tests/cJSON_test)
add_test(NAME libzmq_parse_examples COMMAND ${BINARY_DIR}/tests/parse_examples)

# cJSON的处理逻辑类似

这种方式需要逐个导入依赖的测试，适合依赖数量不多的场景。

备选方案：关闭其中一个依赖的测试（仅当需求可妥协时） #

如果不是必须要跑两个依赖的所有测试，最简单的办法就是关闭其中一个依赖的BUILD_TESTING选项：

FetchContent_Declare(
  libzmq
  GIT_REPOSITORY https://github.com/zeromq/libzmq.git
  GIT_TAG 959a133520dfc80d29e83aa7ef762e1d0327f63b
  CMAKE_ARGS -DBUILD_TESTING=OFF
)

不过这个方案不符合你要统一运行所有测试的核心需求，所以仅作为备选。

综合来看，方案一应该是最适合你的，既解决了目标冲突，又完整保留了所有测试用例，实现成本也很低。

备注：内容来源于stack exchange，提问作者Ramon Blanquer