CMake通过FetchContent引入googletest时find_package(GTest)报错的解决方案问询

你遇到的报错本质是CMake两套GTest引入逻辑的不匹配：

• 你通过add_subdirectory引入的Googletest，会直接生成gtest、gtest_main两个可链接的构建目标，但这种引入方式不会在系统路径留下任何可供find_package检索的库文件、配置文件
• 测试代码里的find_package(GTest REQUIRED)走的是CMake自带的FindGTest.cmake检索逻辑，这套逻辑只会去系统安装路径、手动配置的CMAKE_PREFIX_PATH找已经安装完成的Googletest，完全感知不到你通过源码拉进来的库
• 你之前修改CMAKE_MODULE_PATH指向googletest_BINARY_DIR/googletest/generated没有效果，是因为这个目录放的是Googletest自动生成的平台适配头文件，根本不包含任何可供find_package调用的查找模块或包配置文件。

完全不需要修改测试代码里的find_package(GTest REQUIRED)，只要调整现有CMake的代码顺序和变量赋值就能解决：

1. 调整代码执行顺序
   保证FetchContent拉取、编译Googletest的逻辑，在所有会触发find_package(GTest REQUIRED)的代码之前执行。如果先跑了测试子目录里的查找逻辑、后拉取Googletest，不管怎么配置都会报错。
2. 手动适配FindGTest模块的校验变量
   在现有FetchContent块的后面，加上几行强制赋值的代码，提前把find_package需要校验的几个关键变量，指向你已经拉取进来的Googletest构建目标：

   # 提前为FindGTest模块赋值，跳过系统路径检索
   set(GTEST_INCLUDE_DIR ${googletest_SOURCE_DIR}/googletest/include CACHE PATH "Googletest头文件路径" FORCE)
   set(GTEST_LIBRARY gtest CACHE STRING "Googletest核心库目标" FORCE)
   set(GTEST_MAIN_LIBRARY gtest_main CACHE STRING "Googletest测试入口库目标" FORCE)
   

   这段代码的作用是：后续执行find_package(GTest REQUIRED)时，CMake自带的FindGTest模块会检测到这几个关键变量已经有合法值，直接判定找到GTest，不会再去系统路径检索报缺失错误。
3. 可选的构建优化
   拉取Googletest的时候可以提前关掉不必要的编译选项，加快构建速度，避免和项目的编译策略冲突：

   # 在FetchContent_Populate之前加这几行配置
   set(BUILD_GTEST ON CACHE BOOL "" FORCE)
   set(BUILD_GMOCK OFF CACHE BOOL "" FORCE)
   set(INSTALL_GTEST OFF CACHE BOOL "" FORCE)
   

• 不要尝试通过生成Googletest安装目标来适配find_package，你没有权限在测试机器上安装系统级软件，而且安装操作需要额外的执行步骤和权限，反而会引入新的问题
• 针对你用的release-1.8.0老版本Googletest，不要指望它自带包配置文件供find_package检索——这个版本本身就没有实现GTestConfig.cmake的生成逻辑，就算把它的二进制路径加到CMAKE_PREFIX_PATH里也没用。

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