在使用 testify/suite 构建测试套件后，-run 参数无法直接匹配子测试方法名；需配合 -testify.m 标志指定具体测试函数名，才能精准运行套件中的单个测试方法。

在使用 testify/suite 构建测试套件后，`-run` 参数无法直接匹配子测试方法名；需配合 `-testify.m` 标志指定具体测试函数名，才能精准运行套件中的单个测试方法。

testify/suite 将一组相关测试组织为一个 Go 结构体（如 MySuite），并通过 suite.Run(t, new(MySuite)) 启动。此时整个套件被包装为一个顶层测试函数（例如 TestMySuite），而其中的每个 Test* 方法（如 TestShouldValidateInput）并非独立的 testing.T 函数，而是由 suite 框架在运行时反射调用——因此标准 go test -run 无法直接命中这些内部方法。

✅ 正确做法是组合两个参数：

• -run：匹配顶层套件测试函数名（支持正则，建议用 ^TestSuiteName$ 精确匹配，避免误触发其他测试）；
• -testify.m：指定 suite 内部要执行的具体方法名（不带 Test 前缀，但大小写敏感）。

例如，假设有如下套件：

type CalculatorSuite struct {
    suite.Suite
}

func (s *CalculatorSuite) TestAddition() {
    s.Equal(4, Add(2, 2))
}

func (s *CalculatorSuite) TestSubtraction() {
    s.Equal(1, Subtract(3, 2))
}

func TestCalculatorSuite(t *testing.T) {
    suite.Run(t, new(CalculatorSuite))
}

要仅运行 TestAddition，执行：

go test -v ./services/gateways/... -run ^TestCalculatorSuite$ -testify.m Addition

⚠️ 注意事项：

• -testify.m Addition 中的 Addition 是方法名去掉 Test 前缀后的部分（即 TestAddition → Addition），不可写成 TestAddition；
• -run 值推荐使用 ^TestXxxSuite$ 形式，防止因命名相似（如 TestCalculatorSuiteWithMock）导致意外匹配；
• 该功能依赖 testify v1.8.0+，旧版本可能不支持 -testify.m；可通过 go list -m github.com/stretchr/testify 确认版本；
• 若测试文件中存在多个 suite（如 TestSuiteA 和 TestSuiteB），务必确保 -run 精确限定目标套件，否则 -testify.m 可能被忽略或行为未定义。

? 提示：可将常用命令封装为 Makefile 目标或 shell 别名，提升调试效率。例如：

test-add:
    go test -v ./services/gateways/... -run ^TestCalculatorSuite$ -testify.m Addition

掌握这一机制后，你既能享受 suite 带来的结构化组织优势，又不失单元级测试的快速迭代能力。