Go测试代码不会被编译进生产二进制,因go build默认完全忽略*_test.go文件;测试文件须与被测代码同包同目录才能访问私有标识符;应使用-build标签、-run参数和testing.Short()控制执行,数据文件放testdata子目录并注意跨平台换行符。
Go测试代码会不会被编译进生产二进制?
不会。go build 默认完全忽略 *_test.go 文件,只要文件名符合 Go 测试命名规范(以 _test.go 结尾),就不会参与构建。这是 Go 工具链的硬性规则,不是靠约定或文档约束——连 AST 解析阶段都不会加载这些文件。
验证方式很简单:
go list -f '{{.GoFiles}} {{.TestGoFiles}}' ./...
可以看到 TestGoFiles 列出的文件永远不会出现在最终二进制里。
测试文件放在哪里才安全?
必须和被测代码在同一个包内(即同目录、同 package 声明),否则无法访问未导出标识符(如 func helper() {}),而单元测试往往需要测这些内部逻辑。
常见误操作:
- 把测试放到
test/子目录并声明package test—— 这会变成独立包,测不了原包私有函数 - 用
//go:build ignore或// +build ignore标记测试文件 —— 多余,且可能干扰go test发现测试 - 在
main包里写测试时混用func TestMain和func main—— 会导致构建失败,go test会拒绝运行
如何控制哪些测试在 CI/本地运行?
靠 -run、-short 和构建标签(build tags)组合控制,而不是删文件或改目录结构。