go-test

Go TDD 命令

此命令使用地道的 Go 测试模式为 Go 代码强制执行测试驱动开发（Test-Driven Development，TDD）方法论。

此命令的作用

1. 定义类型/接口：首先搭建函数签名的支架
2. 编写表驱动测试（Table-Driven Tests）：创建全面的测试用例（RED/红灯）
3. 运行测试：验证测试因预期的原因失败
4. 实现代码：编写通过测试所需的最少代码（GREEN/绿灯）
5. 重构（Refactor）：在保持测试通过的同时优化代码
6. 检查覆盖率：确保 80% 以上的覆盖率

何时使用

在以下场景使用 /go-test：

• 实现新的 Go 函数
• 为现有代码增加测试覆盖率
• 修复 Bug（先编写失败的测试）
• 构建核心业务逻辑
• 在 Go 中学习 TDD 工作流（Workflow）

TDD 周期

RED（红灯）      → 编写失败的表驱动测试
GREEN（绿灯）    → 实现通过测试所需的最少代码
REFACTOR（重构） → 优化代码，保持测试通过
REPEAT（循环）   → 下一个测试用例

会话示例

User: /go-test 我需要一个验证电子邮件地址的函数

Agent:
# TDD 会话：电子邮件验证器

## 第 1 步：定义接口

```go
// validator/email.go
package validator

// ValidateEmail 检查给定的字符串是否为有效的电子邮件地址。
// 如果有效返回 nil，否则返回描述问题的错误。
func ValidateEmail(email string) error {
    panic("not implemented")
}

第 2 步：编写表驱动测试 (RED)

// validator/email_test.go
package validator

import (
    "testing"
)

func TestValidateEmail(t *testing.T) {
    tests := []struct {
        name    string
        email   string
        wantErr bool
    }{
        // 有效邮箱
        {"simple email", "[email protected]", false},
        {"with subdomain", "[email protected]", false},
        {"with plus", "[email protected]", false},
        {"with dots", "[email protected]", false},

        // 无效邮箱
        {"empty string", "", true},
        {"no at sign", "userexample.com", true},
        {"no domain", "user@", true},
        {"no local part", "@example.com", true},
        {"double at", "user@@example.com", true},
        {"spaces", "user @example.com", true},
        {"no tld", "user@example", true},
    }

    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            err := ValidateEmail(tt.email)
            if tt.wantErr && err == nil {
                t.Errorf("ValidateEmail(%q) = nil; want error", tt.email)
            }
            if !tt.wantErr && err != nil {
                t.Errorf("ValidateEmail(%q) = %v; want nil", tt.email, err)
            }
        })
    }
}

第 3 步：运行测试 - 验证失败

$ go test ./validator/...