GoogleTest 匹配器(Matchers)全面指南：从基础到高级用法-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01080/article/details/148328088

GoogleTest 匹配器(Matchers)全面指南：从基础到高级用法

googletest GoogleTest - Google Testing and Mocking Framework 项目地址: https://gitcode.com/gh_mirrors/googl/googletest

前言

在单元测试中，验证预期结果与实际结果是否匹配是最核心的任务之一。GoogleTest 提供了一套强大的匹配器(Matchers)系统，可以让我们以声明式的方式编写测试断言，使测试代码更简洁、更具可读性。本文将全面介绍 GoogleTest 中各种匹配器的使用方法。

匹配器基础概念

匹配器(Matcher)是用于验证单个参数是否符合特定条件的工具。在 GoogleTest 中，主要通过两个宏来使用匹配器：

EXPECT_THAT(actual_value, matcher) - 验证实际值是否符合匹配器条件
ASSERT_THAT(actual_value, matcher) - 功能同上，但失败时会产生致命错误

重要提示：虽然可以直接使用 EXPECT_THAT(actual_value, expected_value) 进行相等性比较，但隐式类型转换可能导致意外结果。最佳实践是明确使用 Eq() 匹配器或 EXPECT_EQ。

常用匹配器分类

1. 通配符匹配器

_ - 匹配任何类型的任何值
A<type>() 或 An<type>() - 匹配指定类型的任何值

2. 通用比较匹配器

| 匹配器 | 描述 | |---------------|-----------------------------| | Eq(value) | 参数等于指定值 | | Ge(value) | 参数大于等于指定值 | | Gt(value) | 参数大于指定值 | | Le(value) | 参数小于等于指定值 | | Lt(value) | 参数小于指定值 | | Ne(value) | 参数不等于指定值 | | IsNull() | 参数是空指针(原始或智能指针) | | NotNull() | 参数是非空指针(原始或智能指针) |

3. 浮点数匹配器

GoogleTest 提供了多种浮点数比较方式：

DoubleEq/FloatEq - 近似相等比较，将 NaN 视为不等
NanSensitiveDoubleEq/NanSensitiveFloatEq - 近似相等比较，将 NaN 视为相等
DoubleNear/FloatNear - 允许指定最大绝对误差的近似比较

这些匹配器使用基于 ULP(Unit in the Last Place)的比较算法，能根据预期值的绝对值自动选择合理的误差范围。

4. 字符串匹配器

支持 C 字符串和 C++ string 对象：

| 匹配器 | 描述 | |--------------------|------------------------| | ContainsRegex | 包含匹配的正则表达式 | | EndsWith | 以指定字符串结尾 | | HasSubstr | 包含指定子字符串 | | MatchesRegex | 完全匹配正则表达式 | | StartsWith | 以指定字符串开头 | | StrCaseEq | 字符串相等(忽略大小写) |