Golang测试函数写法与Test命名技巧

Go语言的测试函数必须严格遵循`func TestXxx(t *testing.T)`命名规范，置于同包的`*_test.go`文件中，任何偏差（如参数类型错误、函数名不以大写字母开头、文件名不符或混入业务代码）都会导致`go test`完全忽略该测试；子测试名需避免斜杠和空格以确保可过滤与稳定运行；而测试文件的纯净性——不嵌入非测试逻辑、不引入无关依赖——更是保障测试隔离性、可维护性和CI可靠性的关键底线，这些不是编码风格选择，而是Go测试框架不可妥协的底层契约。

Go 测试函数必须叫 Test*，且参数只能是 *testing.T

Go 的测试框架靠函数名和签名识别测试用例，不是靠注解或配置。如果你写了个函数叫 checkLogin 或 TestLogin 但参数是 int，go test 根本不会执行它。

• func TestXxx(t *testing.T) 是唯一被识别为测试的格式，Xxx 必须大写字母开头（否则包外不可见，测试也无法导入）
• 不能是 func TestXxx(t *testing.B) —— 那是基准测试，要用 go test -bench
• 不能漏掉 *testing.T 参数，哪怕你什么都没调用；少一个星号（testing.T）也会编译失败
• 函数必须放在 _test.go 文件里，且文件名要匹配（如 user_test.go 对应 user.go）

为什么 go test 找不到你的 TestXxx 函数

常见原因是包作用域或构建约束没对上。Go 不会跨包运行测试，也不会加载被 // +build 排除的文件。

• 确认测试函数和被测代码在同一个包（比如都是 package user），别误写成 package user_test（那是黑盒测试专用，且需显式导入原包）
• 检查文件名是否含 _test.go，且没有拼错（user.test.go 或 user_test.g0 都无效）
• 如果用了构建标签（如 // +build integration），记得加 -tags=integration 才能运行
• 运行时用 go test -v ./... 看完整路径输出，确认目标包确实被扫描到了

t.Run() 嵌套子测试时，名字不能含斜杠或空格

子测试名会出现在 go test -v 输出里，也用于 -run 过滤。非法字符会导致跳过或 panic。

• 正确：t.Run("valid_email", ...)、t.Run("empty_input", ...)
• 错误：t.Run("user/email", ...)（斜杠被解释为子测试层级，但顶层函数名不含斜杠，会报 invalid test name）
• 错误：t.Run("email with space", ...)（空格会让 -run "email with space" 解析失败）
• 子测试名不参与 Go 的标识符校验，所以可以是纯数字或下划线开头，但为了可读性和过滤方便，建议只用小写字母、数字、下划线

测试文件里混写业务逻辑会破坏隔离性

很多人图省事，在 xxx_test.go 里定义辅助结构体或工具函数，结果发现主包测试失败后，这些代码还悄悄影响了其他包的构建或测试行为。

• 所有非 Test* 函数、变量、类型，只要没加 //go:build ignore，都会被编译进测试二进制，可能触发意外初始化（比如 init() 里的全局 HTTP client）
• 如果必须复用逻辑，优先用 internal/testutil 包，而不是直接塞进 _test.go
• 特别注意：不要在测试文件里 import 主包以外的、本不该被测试依赖的模块（比如把 database/sql 导入到单元测试里又没 mock，容易让 CI 因环境缺失失败）

测试函数名和签名是 Go 测试系统的硬性契约，不是风格建议；子测试命名看着随意，实则影响可调试性和自动化过滤；而测试文件的“干净度”，往往在项目变大后才暴露问题——那时再拆就不是改个名字的事了。

理论要掌握，实操不能落！以上关于《Golang测试函数写法与Test命名技巧》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！