用途:本技能是 stretchr/testify 的 Go 测试指南,用于编写与审查测试代码。testify 为 Go 标准 testing 包补充可读断言、mock 与 suite,但不替代 testing,入口始终是 *testing.T。
主要能力:assert 与 require 提供相同断言,区别在失败行为——assert 记录失败后继续,可一次看到全部失败;require 调用 t.FailNow(),用于继续会 panic 或误导的前置条件。可用 assert.New(t) / require.New(t) 提升可读性。断言覆盖相等、Nil/布尔/空值、包含、比较、错误链(ErrorIs、ErrorAs、ErrorContains)、类型判断,以及 ElementsMatch、InDelta、JSONEq、WithinDuration、Regexp、Eventually、EventuallyWithT 等高级用法。mock 通过嵌入 mock.Mock 与 m.Called() 隔离被测单元,配合 mock.Anything、mock.AnythingOfType、mock.MatchedBy 及 .Once()、.Times(n)、.Maybe()、.Run() 等修饰符,并用 AssertExpectations(t) 验证。suite 用 SetupSuite、SetupTest、TearDownTest、TearDownSuite 组织共享前置与清理,必须用 suite.Run(t, new(XxxSuite)) 启动。
使用方式:断言参数顺序固定为 (expected, actual);前置条件用 require,验证用 assert,不要随意混用。套件方法如 s.Equal() 等同 assert,require 用 s.Require().NotNil(obj)。
适用场景:编写新测试或 mock、审查既有测试中的 testify 误用。
限制与常见错误:忘记 AssertExpectations(t) 会让 mock 期望静默通过;用 is.Equal 比较包装错误会失败,应改用 ErrorIs;参数顺序颠倒会产生反向 diff;用 assert 做守卫会在失败后继续并可能空指针 panic;缺少 suite.Run() 会导致零测试静默执行;比较指针比较的是地址。可用 testifylint 检查参数顺序与 assert/require 误用。本技能并非穷尽,更多信息请参考库文档与代码示例。