CMake中跨目录相互依赖目标的配置方法咨询

核心思路是不在子目录间互相调用add_subdirectory()，而是在顶层CMakeLists.txt中统一加载所有涉及的子目录，让所有目标进入CMake的全局作用域，之后直接引用目标名（或别名）建立依赖，效果和Bazel的全限定目标名机制类似。

具体实现步骤： #

1. 顶层统一加载所有子目录
   在项目最顶层的CMakeLists.txt中，一次性添加所有需要的子目录，顺序不影响CMake的依赖解析：

   # 顶层CMakeLists.txt
   cmake_minimum_required(VERSION 3.10)
   project(YourProjectName)
   
   # 统一添加所有涉及的子目录，无需考虑层级或依赖顺序
   add_subdirectory(folder1)
   add_subdirectory(folder2)
   

2. 子目录中直接引用目标建立依赖

   • 在folder1/CMakeLists.txt中，让target2依赖folder2的target1：

     # folder1/CMakeLists.txt
     # 定义自身目标
     add_library(target1 [源文件列表])
     
     add_library(target2 [源文件列表])
     # 直接引用folder2中的目标，若担心重名可使用别名
     target_link_libraries(target2 PRIVATE folder2_target1)
     

   • 在folder2/CMakeLists.txt中，让target1依赖folder1的target1：

     # folder2/CMakeLists.txt
     # 定义自身目标，可设置别名避免重名
     add_library(target1 [源文件列表])
     add_library(folder2::target1 ALIAS target1)
     
     # 引用folder1中的目标
     target_link_libraries(target1 PRIVATE target1)
     

   若目标名存在冲突，推荐用add_library(别名 ALIAS 真实目标)创建命名空间别名（如folder2::target1），和Bazel的全限定目标名逻辑一致，可读性更强。

3. 关键注意事项

   • 绝对不要在子目录中互相调用add_subdirectory()，这会触发CMake的循环引用检测，导致无限递归、内存占用过高甚至IDE崩溃。
   • CMake中所有被定义的目标都是全局可见的，只要在顶层完成子目录加载，跨目录引用目标无需额外配置，和Bazel的目标引用逻辑一致。
   • 即使目录是嵌套层级关系（比如folder2是folder1的子目录），依然在顶层直接添加add_subdirectory(folder1)和add_subdirectory(folder2)即可，CMake会自动处理路径问题。

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