go测试文件须以_test.go结尾且与被测代码同目录同包;测试函数以test开头、参数为*testing.t;用-go test -run指定函数、-v查看日志、-cover测覆盖率;依赖解耦靠接口+fake实现,禁用monkey打桩。

Go 自带 testing 包,无需额外安装框架就能跑单元测试;但要真正用好,得配好目录结构、辅助工具和运行习惯。
Go 测试文件命名和位置怎么定
Go 要求测试文件名必须以 _test.go 结尾,且和被测代码放在同一包(同一目录)下。比如 calculator.go 的测试必须写在 calculator_test.go 中,不能挪到 test/ 子目录里——否则 go test 找不到它,也不属于同一个包,无法访问未导出函数或字段。
- 测试文件中函数名必须以
Test开头,且首字母大写,参数类型固定为*testing.T - 想测性能?用
Benchmark开头 +*testing.B参数;想测示例?用Example开头 - 别把测试逻辑写在
main()里——go test不执行 main 包的 main 函数
如何快速运行和调试单个测试函数
用 -run 参数指定测试函数名最直接,支持正则匹配:
go test -run=TestAdd
如果测试失败,默认只报错不输出日志。加 -v 可看到每个测试的执行过程和 t.Log() 输出:
立即学习“go语言免费学习笔记(深入)”;
go test -v -run=TestAdd
- 想看覆盖率?加
-cover;想生成 HTML 报告?链式执行:go test -coverprofile=c.out && go tool cover -html=c.out - 测试依赖外部服务?用
if testing.Short() { t.Skip("skipping in short mode") }配合go test -short快速跳过 - 别在测试里硬编码路径,用
t.TempDir()创建临时目录更安全
mock 和依赖注入怎么做才不破坏 Go 原生测试体验
Go 没有“自动 mock 框架”的强依赖,推荐用接口 + 组合来解耦。比如被测函数依赖一个数据库操作,就定义 type DB interface { Query(...) },测试时传入实现该接口的 fake 结构体:
type FakeDB struct{}<br>func (f FakeDB) Query(sql string) ([]byte, error) { return []byte("mock"), nil }
然后在测试中构造依赖对象,而不是改生产代码去适配测试。
- 别用
monkey等打桩库 patch 函数——它依赖 unsafe,不兼容新版本 Go,CI 极易失败 - HTTP 客户端测试优先用
httptest.Server或http.Client{Transport: &http.Transport{...}}替换 transport - 时间相关逻辑?把
time.Now()封装成可注入的函数变量,测试时替换为固定时间
go.mod 里要不要加 test 相关依赖
绝大多数情况下不用。Go 标准测试流程不依赖第三方模块:测试代码本身是普通 Go 代码,go test 会自动识别并编译 _test.go 文件,连 go build 都不需要显式构建。
- 只有当你用了
testify、gomock这类增强断言或 mock 工具时,才需要go get并在测试文件里 import - 注意:这些工具只是让写法更顺手,并不提升测试能力上限;标准库的
t.Errorf、reflect.DeepEqual已足够覆盖 90% 场景 - CI 中避免用
go test ./...扫所有子目录——如果有子模块含集成测试或耗时长的 benchmark,容易拖垮流水线;明确指定包路径更可控,例如go test ./pkg/calculator
真正容易被忽略的是测试的“隔离性”:每个测试函数应独立运行、不共享状态、不依赖执行顺序。哪怕只漏掉一个 defer db.Close() 或没重置全局变量,都可能让后续测试静默失败。










