使用CMake配置GoogleTest项目失败：EXPECT_THAT等符号未定义

嘿，我之前搭建GTest项目时也踩过这个坑！你遇到的EXPECT_THAT和ContainerEq未定义的错误，本质是GoogleTest的匹配器（Matchers）模块没被正确引入，给你一步步解决的办法：

1. 先检查头文件是否正确引入 #

EXPECT_THAT和ContainerEq不属于GoogleTest的基础核心头，需要单独引入匹配器相关的头文件：

• 如果你用的是较新版本的GTest（1.10+），直接引入匹配器专用头即可：

  #include <gtest/gtest-matchers.h>
  

• 要是你同时用到了GMock，引入GMock的头也能覆盖匹配器的定义：

  #include <gmock/gmock.h>
  

  （注意：用这个头的话，CMake里也要记得链接GMock库）

2. 确认CMake配置是否正确链接GTest组件 #

如果头文件加了还是报错，大概率是CMake没把匹配器相关的库链接到你的测试目标，分两种场景处理：

场景A：用FetchContent自动拉取GTest（现代CMake推荐方式） #

如果你的CMake是通过FetchContent下载GTest的，确保配置里完整链接所需库：

include(FetchContent)
FetchContent_Declare(
  googletest
  URL https://github.com/google/googletest/archive/refs/tags/v1.14.0.zip
)
# 避免将GTest安装到系统路径
set(gtest_force_shared_crt ON CACHE BOOL "" FORCE)
FetchContent_MakeAvailable(googletest)

# 定义你的测试可执行文件
add_executable(MyTestTarget test.cpp)
# 链接gtest、gtest_main（自动提供main函数）以及gmock（如果用了gmock的头）
target_link_libraries(MyTestTarget PRIVATE GTest::gtest GTest::gtest_main GTest::gmock)

# 启用CTest自动发现测试用例
include(GoogleTest)
gtest_discover_tests(MyTestTarget)

场景B：系统已预装GoogleTest #

如果是通过系统包管理器（比如apt、brew）安装的GTest，确保CMake正确找到并链接库：

find_package(GTest REQUIRED)
add_executable(MyTestTarget test.cpp)
target_link_libraries(MyTestTarget PRIVATE GTest::GTest GTest::Main GTest::GMock)

3. 版本兼容性检查 #

如果是非常老旧的GTest版本（比如1.8之前），ContainerEq可能没有被纳入标准匹配器，或者需要用::testing::ElementsAreArray这类替代方法。这种情况下，建议你升级到1.10及以上的GTest版本，新版本对匹配器的支持更完善，也能避免很多兼容性问题。

完成以上步骤后，重新运行CMake构建（比如cmake --build .），应该就能解决这两个编译错误了。

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