# 基础用法 - 为指定文件生成测试
/go-test-gen <source_file>

# 分析覆盖率并生成缺失的测试
/go-test-gen --coverage <source_file>

# 生成基准测试
/go-test-gen --benchmark <source_file>

# 更新已有测试（补充缺失的测试用例）
/go-test-gen --update <test_file>

# 生成 Mock 接口实现
/go-test-gen --mock <interface_name> <source_file>

# 批量生成整个包的测试
/go-test-gen --package <package_path>

1. 解析命令参数
   ├─ 确定源文件路径和生成模式
   └─ 读取项目配置文件

2. 分析源代码
   ├─ 使用 Go AST 解析源文件
   ├─ 提取函数签名和文档注释
   └─ 分析函数复杂度和依赖

3. 检查已有测试
   ├─ 查找 *_test.go 文件
   └─ 识别缺失的测试场景

4. 生成测试代码
   ├─ 选择测试模板（表驱动/简单/并发）
   ├─ 生成测试用例结构
   └─ 应用项目规范

5. 验证和优化
   ├─ 格式化生成的代码（gofmt）
   ├─ 运行 golangci-lint 检查
   └─ 运行生成的测试并报告覆盖率

6. 输出结果
   └─ 显示生成的文件、测试运行结果和改进建议

func Test{FunctionName}(t *testing.T) {
    t.Parallel()

    tests := []struct {
        name    string
        // ... 参数字段
        want    {ReturnType}
        wantErr bool
    }{
        {name: "scenario_1", /* ... */ },
        {name: "scenario_2", /* ... */ },
    }

    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            t.Parallel()
            // Arrange, Act, Assert
        })
    }
}

func Test{FunctionName}_{Scenario}(t *testing.T) {
    t.Parallel()

    // Arrange
    // Act
    // Assert (使用 assert/require)
}

func Test{FunctionName}_ConcurrentSafe(t *testing.T) {
    t.Parallel()

    var wg sync.WaitGroup
    const goroutines = 100

    for i := 0; i < goroutines; i++ {
        wg.Add(1)
        go func(idx int) {
            defer wg.Done()
            // Act & Assert
        }(i)
    }

    wg.Wait()
}

func Benchmark{FunctionName}(b *testing.B) {
    // Arrange
    b.ReportAllocs()
    b.ResetTimer()

    for i := 0; i < b.N; i++ {
        {FunctionName}(/* params */)
    }
}

func Benchmark{FunctionName}_Parallel(b *testing.B) {
    b.ReportAllocs()
    b.ResetTimer()

    b.RunParallel(func(pb *testing.PB) {
        for pb.Next() {
            {FunctionName}(/* params */)
        }
    })
}

// 示例：为这个函数生成边界测试
func ProcessUsers(users []User, limit int) ([]User, error)

// 自动生成场景：
// - users == nil
// - users == []User{}
// - len(users) == 1
// - len(users) == limit
// - len(users) > limit
// - limit == 0, limit < 0, limit > len(users)

📊 测试生成报告
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ 已生成文件: {file_path}

📝 生成的测试函数 ({count} 个):
  • TestFunction1_Scenario1
  • TestFunction1_Scenario2
  • TestFunction2

🧪 运行测试:
  $ go test ./{package} -run TestFunction

📈 覆盖率变化:
  {file}: {before}% → {after}% (+{delta}%)

💡 改进建议:
  • {suggestion_1}
  • {suggestion_2}

⚡ 下一步:
  /go-test-gen --benchmark {file}