Go testing.TB.Output 何时能拿到日志：并行测试与输出捕获边界

CI 里有一类日志很难看：并行子测试明明写了诊断信息，失败时却只看到一半。Go 1.25 给 testing.TB 增加了 Output，它把普通写入接到与 TB.Log 相同的测试输出流，但不会替你补换行，也不会绕过测试生命周期。

Output 适合把一个库函数的 io.Writer 接口接入测试日志；写入会按行缓冲，调用 Log 或测试结束时刷新，测试函数及其父测试返回后就不能再调用它。

并行子测试里，日志为什么像被截断

先看一个可运行的场景。被测函数只认识 io.Writer，测试通过 t.Output() 把诊断流接进去；子测试调用 t.Parallel()，但在返回前用 sync.WaitGroup 等待后台写入完成。

func writeDiagnostic(w io.Writer, name string) {
    fmt.Fprintf(w, "case=%s", name)
}

func TestOutput(t *testing.T) {
    t.Run("parallel", func(t *testing.T) {
        t.Parallel()
        var wg sync.WaitGroup
        wg.Add(1)
        go func() {
            defer wg.Done()
            writeDiagnostic(t.Output(), "parallel")
        }()
        wg.Wait()
        t.Log("finished")
    })
}

这里有三条真实路径：writeDiagnostic 调用 t.Output 得到 writer，fmt.Fprintf 写入同一测试输出流，最后 t.Log 让尚未结束的一行获得刷新机会。并行只改变调度顺序，不改变“测试返回后不能写”的约束。

Output 和 Log 到底差在哪里

t.Log 是测试报告方法：它会格式化参数并自动补换行，在失败测试或开启详细输出时显示。t.Output 返回一个 io.Writer，输出仍归测试框架管理，但写入本身不添加源位置和换行。

因此适配器可以保持业务函数不认识 *testing.T：

func dump(w io.Writer) {
    io.WriteString(w, "header")
    io.WriteString(w, "\nbody\n")
}

func TestDump(t *testing.T) {
    dump(t.Output())
}

如果把 Output 当成无缓冲的标准输出，就容易在排查时误判。官方文档说明它内部按行缓冲；写入不含换行的 header 不会因为函数返回值暂时离开缓冲区，而 Log 或测试结束会推动它刷新。

三个容易踩中的生命周期边界

不要让后台 goroutine 越过测试返回

文档明确限制：测试函数和所有父测试返回之后，Output 以及它返回的 Write 都不能再调用。用 WaitGroup、通道或其他明确的收尾信号，把后台工作收在测试函数内部。

换行由写入方负责

Output 不自动补换行，也不添加源码位置。调试记录要么让每条记录自带 \n，要么直接继续使用 t.Log，不要混用后再猜输出格式。

并行不等于立即打印

子测试调用 t.Parallel 后会等待调度；测试输出还要经过测试框架的收集和展示。验证日志时看完整的 go test -v 输出，不要拿一次交错后的终端顺序当作调用顺序。

把验证写进测试代码

我更建议把 writer 适配和收尾作为一个小边界测试：主测试负责创建子测试，子测试负责等待自己的 goroutine。这样失败时能同时检查业务输出和测试框架的结束时机。

func TestOutputLifecycle(t *testing.T) {
    t.Run("writer", func(t *testing.T) {
        var wg sync.WaitGroup
        wg.Add(1)
        go func() {
            defer wg.Done()
            _, _ = io.WriteString(t.Output(), "ready\n")
        }()
        wg.Wait()
    })
}

运行 go test -v -run TestOutputLifecycle，可见成功状态是子测试完成且输出出现在对应测试段落中；若去掉等待，代码仍可能偶尔通过，但已经把写入放到了测试生命周期之外，不能作为可靠方案。

结论：把 Output 当成受测试生命周期管理的 Writer

testing.TB.Output 解决的是“库函数只接受 io.Writer，测试又想纳入测试报告”的连接问题。它和 TB.Log 共用输出流，却保留 writer 的换行责任和测试结束边界。记住调用链、按行缓冲和收尾等待这三点，排查并行测试日志时就不会把显示时机误认为业务丢日志。

常见问题

Output 会把日志打印到标准输出吗？

不会把它当作独立的标准输出通道；它写入与 TB.Log 相同的测试输出流。

写入 Output 后需要手动 Flush 吗？

不需要也没有公开的 Flush 方法。按行缓冲会在调用 TB.Log 或测试结束时隐式刷新。

并行测试可以把 Output 交给 goroutine 吗？

可以在测试函数仍存活期间使用，但必须等待 goroutine 在测试返回前结束；父测试和当前测试都返回后不能再写。