Go 语言中，私有（小写开头）方法只能被同一包内的代码访问；因此测试私有方法的规范做法是将测试文件放在被测包内（同包名），使用 _test.go 后缀但不加 _test 包后缀，从而自然获得对私有成员的访问权限。
go 语言中，私有（小写开头）方法只能被同一包内的代码访问；因此测试私有方法的规范做法是将测试文件放在被测包内（同包名），使用 _test.go 后缀但不加 _test 包后缀，从而自然获得对私有成员的访问权限。
在 Go 的工程实践中，测试代码不应置于独立的 tests/ 目录或单独的 xxx_test 包中来“绕过”可见性限制——这不仅违背 Go 的设计哲学，还会引发编译错误（如 undefined: MyType 或 cannot refer to unexported method），更导致维护成本上升。
✅ 正确做法：将测试文件与生产代码置于同一包、同一目录下，仅通过文件名后缀标识测试：
mypackage/ ├── mytype.go # package mypackage ├── mytype_test.go # package mypackage（关键！不是 mypackage_test）
mytype_test.go 示例：
package mypackage
import "testing"
func TestPrivate(t *testing.T) {
mt := &MyType{}
// ✅ 可直接调用私有方法
mt.private() // 无报错
// 可结合表驱动测试验证内部逻辑
tests := []struct {
name string
input int
want string
}{
{"basic", 42, "ok"},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
result := mt.privateHelper(tt.input)
if result != tt.want {
t.Errorf("got %v, want %v", result, tt.want)
}
})
}
}⚠️ 注意事项：
- 文件名必须以 _test.go 结尾，但 package 声明必须与被测代码完全一致（如 package mypackage），而非 mypackage_test；
- go test 会自动识别并执行当前目录下所有 *_test.go 文件中的 Test* 函数；
- 若需隔离集成测试或跨包测试用例，可使用构建标签（如 //go:build integration）配合 go test -tags=integration，但核心单元测试仍应坚守同包原则；
- 私有方法本身无需导出，正因其作用域受限，才更需被充分测试——它们往往是业务逻辑的关键实现细节。
总结：Go 的可见性规则不是障碍，而是设计约束。拥抱它，把测试写在包内，既简洁、可靠，又符合官方工具链与社区共识。拒绝“hack 包名”或“伪造 internal_test”等非常规方案，才能写出可长期演进的 Go 代码。
