如何让Go测试工具包显示测试用例中错误发生的调用行？

核心问题 #

封装的断言函数调用t.Error()时，错误提示会指向断言函数所在的checks.go文件，而非测试文件中调用断言的代码行。

标准解决方案 #

Go的testing.T提供了Helper()方法，调用它可以将当前函数标记为测试辅助函数，让测试框架跳过该函数的栈帧，错误信息会直接指向调用辅助函数的测试代码行。

修改后的checks.go代码 #

func NoError(t *testing.T, err error, message ...string) {
    t.Helper() // 标记当前函数为测试辅助函数，关键修复
    if err != nil {
        msg := "unexpected error"
        if len(message) > 0 {
            msg = message[0]
        }
        t.Error(msg)
    }
}

测试文件调用（无需改动） #

func TestThis(t *testing.T){
    err := someFuncWithError(...)
    NoError(t, err, "error found")
}

关于runtime.Caller失效的说明 #

你之前尝试的runtime.Caller()方法，本质是手动获取栈帧位置，但测试框架的t.Error()会优先使用自身的栈追踪逻辑，所以无法覆盖默认的错误行显示。而t.Helper()是官方为这类场景设计的标准API，能直接让测试框架调整错误定位的栈帧层级。

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