CMake FetchContent报错：无法创建空路径工作树目录

问题背景 #

在Visual Studio 2017（MSVC v141）环境中，因依赖要求使用自定义安装的CMake>3.12版本，通过FetchContent_Declare结合FetchContent_MakeAvailable引入jsoncpp等Git外部依赖。配置中指定了GIT仓库地址、TAG、SOURCE_DIR/SUBBUILD_DIR等目录参数及CMAKE_ARGS，但配置阶段触发Git克隆失败：

fatal: could not create work tree dir '': No such file or directory

已做排查 #

• 移除ExternalProject_Add相关参数、注释FIND_PACKAGE_ARGS均无法解决问题
• 仅保留GIT_REPOSITORY和GIT_TAG时，配置可正常完成
• 添加除FIND_PACKAGE_ARGS、SOURCE_DIR、SUBBUILD_DIR外的参数，且将CMAKE_ARGS放在同一行时，配置也能正常运行

根源分析 #

FetchContent底层依赖ExternalProject_Add实现，当手动指定SOURCE_DIR或SUBBUILD_DIR时，若路径配置存在以下问题，会导致Git接收到空的工作目录路径：

1. 路径解析失败：使用相对路径、未定义的CMake变量拼接路径，或路径包含空格/特殊字符，导致CMake无法正确解析为有效路径，最终传递给Git的路径为空
2. 早期版本兼容性bug：CMake>3.12的部分早期版本中，FetchContent对自定义SOURCE_DIR/SUBBUILD_DIR的处理存在逻辑缺陷，当指定的目录不存在或权限不足时，不会自动创建，反而返回空路径
3. 目录结构冲突：SUBBUILD_DIR指定的路径与FetchContent默认的构建目录结构冲突，导致路径被覆盖或清空

解决方法 #

1. 优先使用默认目录：删除SOURCE_DIR和SUBBUILD_DIR配置，FetchContent会自动在CMAKE_CURRENT_BINARY_DIR/_deps下生成规范的源码和构建目录，完全规避路径配置错误
2. 若必须自定义目录：
   • 使用绝对路径或通过CMAKE_CURRENT_SOURCE_DIR/CMAKE_CURRENT_BINARY_DIR等全局变量拼接路径，例如：

     SOURCE_DIR "${CMAKE_CURRENT_BINARY_DIR}/jsoncpp-src"
     SUBBUILD_DIR "${CMAKE_CURRENT_BINARY_DIR}/jsoncpp-subbuild"
     

   • 确保路径无空格、特殊字符，且CMake对目标目录有读写权限
3. 规范CMAKE_ARGS格式：将CMAKE_ARGS的所有参数写在同一行，避免换行导致的参数拆分异常（部分CMake版本对多行参数的解析存在bug）

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