Go 测试框架仅识别以 Test 开头且紧随大写字母（如 TestMyFunc）的导出函数为测试用例；私有函数需通过 _ 下划线命名约定（如 Test_myFunc）显式启用内部测试，但需确保测试文件与被测代码同包且非 *_test.go 后缀隔离。
go 测试框架仅识别以 `test` 开头且紧随大写字母（如 `testmyfunc`）的导出函数为测试用例；私有函数需通过 `_` 下划线命名约定（如 `test_myfunc`）显式启用内部测试，但需确保测试文件与被测代码同包且非 `*_test.go` 后缀隔离。
在 Go 中，测试函数的命名规则由 go test 工具严格约定：必须以 Test 开头，且第3个字符必须是大写字母（例如 TestMyFunc），否则该函数将被忽略。这是 Go 测试驱动开发（TDD）的基础约束，源于 testing 包对测试函数的反射匹配逻辑。
因此，当你定义 Testmxxxx(t *testing.T)（即 m 小写）时，它不满足 Test[A-Z] 模式，go test 会直接跳过——这不是 bug，而是设计使然。
✅ 正确测试私有函数（unexported functions）的方法
假设你有如下 mathutil.go 文件：
// mathutil.go
package mathutil
func myFunc(x int) int {
return x * 2
}
func Myfunc(x int) int {
return x + 1
}
要分别测试这两个函数，需注意：
-
Myfunc 是导出函数（首字母大写），可直接在 mathutil_test.go 中用标准命名测试：
// mathutil_test.go func TestMyfunc(t *testing.T) { got := Myfunc(3) if got != 4 { t.Errorf("expected 4, got %d", got) } } -
myFunc 是私有函数（小写开头），不能跨包调用，但可在同一包内直接测试。此时推荐使用下划线命名法（Go 官方认可的惯用方式）：
// mathutil_test.go —— 注意：必须与 mathutil.go 同包（package mathutil），且不能是 mathutil_internal_test.go 等隔离包 func Test_myFunc(t *testing.T) { got := myFunc(5) if got != 10 { t.Errorf("expected 10, got %d", got) } }
⚠️ 关键前提：
- 测试函数必须与被测代码位于同一包（即 package mathutil），而非 package mathutil_test；
- 文件名可以是 mathutil_test.go，但必须声明 package mathutil（即“同包测试”），否则无法访问私有标识符；
- 运行命令仍为 go test，无需额外标志——只要函数名匹配 Test_.* 模式且在可访问作用域内，即可执行。
? 补充说明：为什么 Test_ 是安全且推荐的？
Go 文档明确指出：Test 后接下划线（Test_）是合法前缀，用于测试未导出符号或特殊场景（如基准测试 Benchmark_、模糊测试 Fuzz_）。它不会触发导出要求，也不违反封装原则——因为测试本身属于开发时的内部验证行为。
✅ 最佳实践总结：
- 导出函数 → TestExportedName
- 私有函数 → Test_privateName（同包内）
- 避免 testMyFunc、test_myFunc 等非 Test 开头写法（会被忽略）
- 不要将私有函数测试拆到 *_test 包中（会导致编译错误：undefined: myFunc）
通过合理运用 Test_ 命名约定，你既能保持代码封装性，又能实现 100% 函数级覆盖，真正践行 Go 的“测试即文档”理念。
