writing-go-tests

此技能作为在 Go 代码库中实施高质量单元测试、集成测试与性能测试的全面指南。专为致力于通过严格遵循现代 Go 测试标准与习惯，以维持可靠、可维护且易于测试代码的软件工程师所设计。通过应用这些准则，开发人员能有效降低回归风险、改善覆盖率指标，并确保系统在并发负载下正确运行。此技能提供了处理复杂依赖性、提升执行速度以及管理测试夹具（fixtures）与清理任务的明确策略。

• 主要功能包含使用基于 map 的表格驱动测试架构，以获得更佳的失败输出可读性。
• 实作 Go 1.24+ 特性（如 testing/synctest）以进行确定性并发测试，消除不稳定的测试（flaky tests）。
• 关于 Mock 与测试替身（test doubles）的实用建议，优先考虑使用 Testcontainers 等真实依赖性的集成测试，而非复杂的代码生成 Mock。
• 关于覆盖率目标的最佳实践，主张 70-80% 的实用基准，而非仅追求绝对数值。
• 关于测试组织的特定指导，利用内部测试处理未导出逻辑，外部封装处理 API 集成测试。
• 资源清理技术，优先使用 t.Cleanup() 而非传统的 defer 陈述式，以实现更干净的测试生命周期管理。

使用此技能时，AI 将建议使用 google/go-cmp 进行深层相等检查，并在标准库不足时引入 testify 进行丰富的断言。它协助通过建议 B.Loop() 模式与 benchstat 统计验证来优化基准测试套件。使用者应注意此技能强调“行为驱动测试”而非实作细节，并专注于务实的卓越品质。此技能主要用于代码重构、新功能开发，或诊断测试套件性能问题时。它能协助识别复杂情境（如 golden file 测试或特定环境配置）的最佳实作路径，而不依赖僵化的 build tags。