在Go的T.Cleanup()中访问testing.T实例是否安全且有官方保障？

核心结论 #

在T.Cleanup()中访问并操作testing.T实例（比如调用t.FailNow()）是安全且符合Go测试框架设计预期的，不存在竞态条件风险。

为什么安全？ #

Go测试框架的执行逻辑从底层保证了Cleanup函数的调用上下文：

• Cleanup函数会在当前测试函数执行完成后，由运行测试的同一个goroutine依次执行，和测试函数本身属于同一执行流，不存在并发访问testing.T实例的场景；
• testing.T的方法（如FailNow()、Error()）本身就是为单goroutine测试执行流程设计的，Cleanup的调用逻辑完全契合这个设计前提。

你给出的示例代码不仅能正常运行，还会正确标记测试失败，这是完全合法的用法。

保守原则下的选择 #

如果秉持极致保守的开发原则，确实可以选择间接方式实现类似逻辑：比如在测试函数中用变量记录需要触发失败的状态，再在Cleanup中根据状态执行操作。但这属于过度谨慎——Go社区的普遍实践（包括大量官方库的测试用例）都直接在Cleanup中操作testing.T，从未出现过因竞态导致的问题。

如何获取官方层面的确认 #

由于GitHub Issue不接受这类用法确认类问题，你可以通过以下途径获取官方认可的答案：

• 参考Go标准库的测试代码：比如net/http、encoding/json等核心包的测试用例中，存在大量在Cleanup中调用t.Fail()、t.Log()等方法的写法，这相当于官方给出的实践示例；
• 参与Go官方社区讨论：通过Go的官方邮件列表或者Discord社区提问，这类用法问题通常会有核心开发者给出明确答复；
• 从T.Cleanup的设计意图推导：该方法的定位就是用于测试后的清理与状态校验，本身就隐含了允许操作测试实例的设计逻辑。

内容的提问来源于stack exchange，提问作者ynn