go test -timeout 控制整个测试命令的总耗时，超时则强制终止进程；它不作用于单个测试函数或子测试，也与 http.client.timeout、context.withtimeout 无关。
go test -timeout 只控制整个测试命令的生命周期，不是单个测试函数的超时。 它是进程级“总闸门”，超时就 kill 进程，不干预内部逻辑。
go test -timeout 是什么，不是什么
它是一个命令行参数，作用于 go test 进程启动到退出的**总耗时**。比如 go test -timeout 30s 表示：从你敲下回车开始计时，30 秒一到，不管当前在跑哪个 TestXxx、是否卡在 t.Run() 里、有没有 goroutine 正在 sleep，进程直接被终止，并报错 test killed with quit: ran too long (30s)。
- 它不作用于单个
func TestXxx(t *testing.T)，更不穿透到t.Run("sub", ...)子测试 - 它和
http.Client.Timeout、context.WithTimeout完全无关，三者彼此独立 - Go 1.22+ 支持复合单位如
-timeout 5m30s；旧版本建议统一用s或m，避免解析失败 - 必须带单位，
-timeout 99999会报错time missing unit in duration
为什么测试里还卡住，-timeout 没生效
常见原因不是参数写错，而是环境或配置干扰：
- IDE（如 VS Code Go 扩展）可能缓存上次测试命令参数，改了
-timeout后没刷新——试试重启测试终端或清 IDE 缓存 - CI 平台（如 GitHub Actions）自身有
timeout-minutes，若平台级 timeout 先触发，go test -timeout根本没机会起作用 - 测试中用了
time.Sleep+select+time.After但没监听ctx.Done()，这种手动超时不响应进程级中断，只能靠-timeout强杀 - 测试调用了阻塞式系统调用（如未设超时的
exec.Command().Run()），子进程没继承信号，go test杀的是主进程，子进程可能残留
如何真正控制单个测试或子测试的耗时
Go 测试框架没有原生 “每个 t.Run() 单独设超时” 的机制。要实现，得手动加控制：
- 对简单场景：在
t.Run()内部用ctx, cancel := context.WithTimeout(context.Background(), 500*time.Millisecond)，然后把ctx传给待测函数（如 HTTP client、DB 查询），最后defer cancel() - 对通用封装：写一个辅助函数，比如
RunWithTimeout(t *testing.T, d time.Duration, f func(t *testing.T))，内部启动 goroutine +select等待完成或超时，超时则t.Fatal - 注意别漏掉清理：比如用
httptest.Server时，必须显式调srv.Close()，否则端口占着，下次测试直接失败 - 避免嵌套超时误判：外层
go test -timeout 1m包含所有 setup/teardown 时间，别指望 10 个子测试各占 5s 就刚好凑满 1m —— 调度、GC、I/O 延迟都会吃掉预算
最容易忽略的是：超时不是目的，验证行为才是重点。比如 HTTP 超时测试，关键不是“它挂了”，而是确认代码返回了 context.DeadlineExceeded、没泄露 goroutine、连接被 Transport 正确关闭。这些都得靠断言和资源观测来验证，光靠 -timeout 命令远远不够。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
