CMake无法加载自定义模块add_FetchContent_MakeAvailable求助

从你的文件夹结构和CMakeLists代码来看，你已经尝试通过添加CMAKE_MODULE_PATH来引入自定义模块，但遇到了找不到文件的错误。我来帮你梳理几个排查方向和解决步骤：

1. 先确认路径和文件名的准确性 #

• 验证根目录路径：在list(APPEND CMAKE_MODULE_PATH)之后添加一行调试输出：

  message(STATUS "CMAKE_SOURCE_DIR: ${CMAKE_SOURCE_DIR}")
  

  运行CMake后，查看输出的路径是否确实指向你的project根目录（也就是包含cmake文件夹的那个目录）。如果路径不对，说明CMAKE_SOURCE_DIR不是你预期的目录，可能是嵌套项目等特殊场景导致的。
• 检查文件名拼写和大小写：确保cmake文件夹里的文件确实是add_FetchContent_MakeAvailable.cmake，没有拼写错误（比如下划线、字母大小写，Linux/macOS系统是区分文件名大小写的，Windows不区分）。CMake的include指令会自动补全.cmake后缀，所以你写include(add_FetchContent_MakeAvailable)是没问题的，但前提是文件名完全匹配。

2. 确认CMAKE_MODULE_PATH是否正确添加 #

同样添加调试输出查看当前的模块路径：

list(APPEND CMAKE_MODULE_PATH "${CMAKE_SOURCE_DIR}/cmake")
message(STATUS "CMAKE_MODULE_PATH: ${CMAKE_MODULE_PATH}")

运行CMake后，检查输出里是否包含你添加的${CMAKE_SOURCE_DIR}/cmake路径。如果没有，尝试改用CMAKE_CURRENT_SOURCE_DIR（它指向当前CMakeLists.txt所在的目录）：

list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake")

3. 用绝对路径直接测试 #

先绕开CMAKE_MODULE_PATH，直接用绝对路径引入模块，看是否能成功：

if(${CMAKE_VERSION} VERSION_LESS 3.14)
    include("${CMAKE_SOURCE_DIR}/cmake/add_FetchContent_MakeAvailable.cmake")
endif()

如果这样能成功，说明问题出在CMAKE_MODULE_PATH的配置上；如果还是失败，那就要检查文件是否真的存在，或者是否有读取权限。

4. 检查文件权限（针对Linux/macOS） #

如果你是在类Unix系统上开发，确保add_FetchContent_MakeAvailable.cmake文件有可读权限。可以在终端执行：

ls -l cmake/add_FetchContent_MakeAvailable.cmake

如果权限显示没有r（读权限），执行以下命令添加：

chmod +r cmake/add_FetchContent_MakeAvailable.cmake

5. 确认CMake版本逻辑是否触发 #

添加一行输出查看当前CMake版本：

message(STATUS "Current CMake version: ${CMAKE_VERSION}")

确保你的CMake版本确实小于3.14，因为只有满足这个条件时，include指令才会执行。如果版本>=3.14，这段代码根本不会运行，那报错可能来自其他地方（不过根据你的描述，应该是进入了if分支）。

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