现代CMake构建vendored代码与Git子模块的最佳实践相关问询

1. 现有思路合理性判断 #

你们的探索方向没有问题，不属于根本性错误，是嵌套项目依赖管理场景下的常见实践路径。现有方案的缺陷本质是没有统一依赖查找入口，也没有明确声明依赖的版本约束，才会出现顺序依赖和目标不匹配的问题。

2. CMake内置特性说明 #

CMake有原生支持这类场景的特性，你可能没有注意到：

• 3.14+版本的FetchContent_MakeAvailable原生处理同名目标重复引入问题，会自动判断依赖是否已经存在，存在则直接跳过引入流程。
• 3.24+版本新增的FETCHCONTENT_TRY_FIND_PACKAGE_MODE变量，可直接实现三级依赖查找逻辑：优先匹配系统安装的符合版本要求的依赖，其次匹配上层项目已经引入的符合版本要求的依赖，最后才引入项目自带的vendored版本。
• CMake官方明确推荐所有依赖统一使用命名空间别名目标（如geos::geos）进行链接，天然兼容源码引入、系统安装引入两种场景。

3. 相关学习资源 #

• 《Professional CMake: A Practical Guide》第14-17章详细覆盖了子模块引入、find_package机制、多项目嵌套构建的完整场景，包含新旧项目兼容的实操方案。
• CMake官方FetchContent模块文档的「嵌套项目依赖处理」小节，也有对应场景的明确说明，和Packages文档分开存放，你之前可能没有检索到。

4. 兼容三种场景的配置方案 #

MyLib核心配置规则 #

1. 根目录CMakeLists.txt开头添加控制选项，自动适配单独构建/子项目构建场景：

option(MYLIB_USE_VENDORED_GEOS "Use vendored libgeos submodule" OFF)
# 单独构建时默认开启vendored依赖，子项目构建时默认关闭
if(CMAKE_CURRENT_SOURCE_DIR STREQUAL CMAKE_SOURCE_DIR)
  set(MYLIB_USE_VENDORED_GEOS ON CACHE BOOL "Use vendored libgeos submodule" FORCE)
endif()

2. 统一依赖查找逻辑，不管来源统一用命名空间目标链接：

# 先查找符合版本要求的已存在依赖（上层项目引入或系统安装）
find_package(Geos 2.0 REQUIRED)
# 没找到且允许使用vendored版本时引入子模块
if(NOT Geos_FOUND AND MYLIB_USE_VENDORED_GEOS)
  add_subdirectory(submodules/libgeos)
  # 统一创建命名空间别名，兼容不规范的geos原生配置
  if(NOT TARGET geos::geos)
    add_library(geos::geos ALIAS geos)
  endif()
endif()
# 链接时统一使用命名空间目标
target_link_libraries(mylib PUBLIC geos::geos)

3. 上层项目适配逻辑：如果要使用自有版本geos，只需在引入MyLib之前完成geos的引入并创建geos::geos别名即可，MyLib会自动复用已有的依赖，不会重复引入。
4. 单步构建场景不需要额外生成MyLibConfig.cmake或者调用export，上述逻辑已经可以满足需求，没有违和感。

不规范geos配置的FindGeos.cmake优化 #

你提供的写法思路合理，但有两个可优化的点：不需要调用export，避免和系统安装的配置文件冲突；需要增加版本校验逻辑，避免引入不符合要求的版本。修正后写法如下：

if(NOT geos_FOUND)
  # 优先查找系统安装的符合版本要求的依赖
  find_package(Geos 2.0 CONFIG QUIET)
  if(NOT Geos_FOUND)
    add_subdirectory(${CMAKE_CURRENT_LIST_DIR}/../submodules/libgeos)
    if(NOT TARGET geos::geos)
      add_library(geos::geos ALIAS geos)
    endif()
    set(geos_FOUND TRUE CACHE BOOL "Found geos from vendored source" FORCE)
    set(geos_VERSION "2.0.0" CACHE STRING "Geos version" FORCE)
  endif()
endif()
# 强制校验版本符合最低要求
if(geos_VERSION VERSION_LESS "2.0")
  message(FATAL_ERROR "Geos version ${geos_VERSION} is too low, require >=2.0")
endif()

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