使用add_subdirectory引入主仓库与派生仓库时如何避免目标名称冲突？

1. 利用CMake 3.24+的NAME命名空间机制（最优） #

CMake 3.24及以上版本为add_subdirectory新增了NAME参数，可直接为子项目的所有目标添加命名空间前缀，完美解决同名目标冲突问题。

使用方式如下：

# 引入主版本仓库，所有目标会自动带上`main::`前缀
add_subdirectory(${CMAKE_CURRENT_SOURCE_DIR}/main_repo NAME main)

# 引入派生版本仓库，所有目标会自动带上`fork::`前缀
add_subdirectory(${CMAKE_CURRENT_SOURCE_DIR}/fork_repo NAME fork)

# 分别私有链接到两个不同的模块库
add_library(module_main SHARED module_main.cpp)
target_link_libraries(module_main PRIVATE main::your_lib_name)

add_library(module_fork SHARED module_fork.cpp)
target_link_libraries(module_fork PRIVATE fork::your_lib_name)

# 主目标无需直接链接，只需确保模块库能被dlopen找到
add_executable(main_app main.cpp)

这种方式无需修改子项目的CMake配置，完全通过主项目的add_subdirectory参数实现目标隔离，是当前最优的方案。

2. 兼容低版本CMake：让子项目目标名称可配置 #

如果你的CMake版本低于3.24，需要修改子项目的CMakeLists.txt，将库目标名称改为可通过外部变量配置的形式：

子项目修改（仅需一次） #

将子项目中原本的硬编码目标名：

add_library(your_lib_name ...)

修改为：

# 默认使用原目标名，允许外部重写
set(TARGET_NAME ${YOUR_LIB_TARGET_NAME:-your_lib_name})
add_library(${TARGET_NAME} ...)

主项目调用 #

在引入子项目前，分别设置不同的目标名变量：

# 引入主版本，指定目标名为your_lib_main
set(YOUR_LIB_TARGET_NAME your_lib_main)
add_subdirectory(${CMAKE_CURRENT_SOURCE_DIR}/main_repo)

# 引入派生版本，指定目标名为your_lib_fork
set(YOUR_LIB_TARGET_NAME your_lib_fork)
add_subdirectory(${CMAKE_CURRENT_SOURCE_DIR}/fork_repo)

# 分别链接到模块库
add_library(module_main SHARED module_main.cpp)
target_link_libraries(module_main PRIVATE your_lib_main)

add_library(module_fork SHARED module_fork.cpp)
target_link_libraries(module_fork PRIVATE your_lib_fork)

add_executable(main_app main.cpp)

额外注意事项 #

• 确保两个模块库（module_main和module_fork）的构建目录独立，避免编译产物覆盖。
• 如果子项目是静态库，链接到动态模块时，需确保模块间的符号不会冲突（可通过子项目的编译选项添加符号隐藏，比如-fvisibility=hidden）。
• 主目标通过dlopen加载模块时，需指定正确的模块库路径，可通过CMAKE_INSTALL_RPATH或手动设置运行时路径。

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