Go测试需严格遵循命名（Test开头）、签名（*testing.T参数）、文件名（_test.go）规则，正确使用t.Run、t.Parallel、t.Helper，慎用TestMain，避免并发map写入、临时文件未清理、time.Now硬编码等陷阱。
Go 的 testing 包不需要额外安装，开箱即用，但写错函数签名、忽略测试文件命名规则或误用 TestMain 都会导致测试不运行或 panic。
测试函数必须以 Test 开头且接收 *testing.T 参数
Go 测试函数不是靠注解或配置识别的，而是严格依赖命名和签名。任何偏差都会让 go test 直接跳过该函数。
- ✅ 正确写法：
func TestAdd(t *testing.T) - ❌ 错误写法：
func testAdd(t *testing.T)（首字母小写）、func TestAdd()（缺参数）、func TestAdd(t *testing.T, n int)（多参数） - 测试文件名必须以
_test.go结尾，例如calculator_test.go；否则go test不会加载它 -
t.Helper()应在封装的断言函数中调用，否则失败时错误行号指向辅助函数而非真实调用处
使用 t.Run 进行子测试（table-driven testing 的标准姿势）
单个测试函数里验证多个输入输出组合时，不用写一堆 TestXXX1/TestXXX2，而应统一用 t.Run 拆分子测试，便于定位失败用例、支持并行执行。
- 每个子测试可独立调用
t.Parallel()，但仅当测试间无共享状态时才安全 - 子测试名建议具名（如
"positive_numbers"），避免用索引fmt.Sprintf("case_%d", i)，否则失败日志难排查 - 示例片段：
func TestParseURL(t *testing.T) {
tests := []struct {
name string
input string
wantErr bool
}{
{"empty", "", true},
{"valid", "https://example.com", false},
}
for _, tt := range tests {
tt := tt // 闭包捕获
t.Run(tt.name, func(t *testing.T) {
t.Parallel()
_, err := url.Parse(tt.input)
if (err != nil) != tt.wantErr {
t.Errorf("ParseURL() error = %v, wantErr %v", err, tt.wantErr)
}
})
}
}
慎用 TestMain：它接管整个测试流程，容易破坏默认行为
func TestMain(m *testing.M) 是全局入口，常被误用于初始化 DB 或 HTTP server，但实际多数场景不需要——它会绕过 go test 对测试生命周期的管理，比如无法与 -race 或覆盖率工具良好协作。
OpenClaw 技能 — 给定一个 GitHub 仓库 URL，自动解析出 owner/repo 名称，发现其中的 YAML/properties 配置文件及其配对的中文字段说明；在 `workspace/{repo}/` 目录下按同步日期（格式为 `YYYY-MM-DD`）创建时间戳子目录；写入 `.openclaw-config-state.json` 状态文件。每次用户提问前，先比对远程仓库当前 ref（如 `main` 或 `master`）的最新提交 SHA 与本地状态文件中记录的 SHA：
- 仅当必须在所有测试前/后做不可延迟的操作（如启动/关闭外部进程）时才考虑
TestMain - 必须显式调用
os.Exit(m.Run())，漏掉会导致测试进程不退出 - 不要在
TestMain中调用t.Log或t.Fatal——此时*testing.T不可用 - 更轻量的替代方案：在普通测试函数中用
init()或包级变量做一次初始化，配合sync.Once
常见陷阱：并发读写 map、忘记清理临时文件、time.Now() 硬依赖
测试看似通过，但在 CI 或高负载机器上随机失败，往往源于这些隐性状态泄漏。
- 向非线程安全的 map 写入时未加锁（尤其在
t.Parallel()子测试中）→ panic: concurrent map writes - 测试中创建临时文件但没 defer
os.RemoveAll→ 多次运行后磁盘占满或路径冲突 - 直接调用
time.Now()做断言 → 在跨时区或系统时间跳变时失败；应将时间作为参数注入，或用github.com/benbjohnson/clock模拟 - HTTP 测试硬编码端口（如
:8080）→ 并行时端口冲突；改用httptest.NewUnstartedServer或net.Listen("tcp", "127.0.0.1:0")让系统分配空闲端口
最易被忽略的是子测试中的变量捕获问题：循环里直接用 tt 而不声明 tt := tt，会导致所有子测试实际运行时都拿到循环末尾的值。这个 bug 不报错，但测试逻辑完全错乱。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
