go test 找不到测试函数的首要原因是_test.go文件名不规范或与被测代码不在同一包；其次为测试函数名未以Test开头、签名错误，或目录/包不匹配。

_test.go 文件必须和被测代码在同一个包内，且文件名严格匹配 xxx_test.go 格式（不能是 test_xxx.go 或 xxx_test.got），否则 go test 完全不会识别它。

为什么 go test 找不到我的测试函数？

常见原因有三个：

• 测试文件名不是 xxx_test.go（比如写成 xxx_test.go.bak 或 test_xxx.go）
• 测试函数名不以 Test 开头，或参数签名不对（必须是 func TestXxx(t *testing.T)）
• 测试文件和源文件不在同一目录、不同包（例如测试文件声明了 package main_test，但源文件是 package main —— 这种“外部测试”虽合法，但只能测试导出符号，且需确保文件名仍为 _test.go）

xxx_test.go 里能写非 Test 函数吗？

可以，但要注意作用域：

• 以小写字母开头的函数（如 setup()、mockDB()）仅在当前测试文件内可见，适合做测试辅助逻辑
• 以大写字母开头的函数（如 HelperFunc()）会被导出，若该测试文件属于 package xxx_test（即外部测试包），其他测试文件也能引用它；但若属于 package xxx（内部测试），则和普通源码一样受包级可见性约束
• 不要在 _test.go 中定义结构体或变量并期望在非测试代码中使用 —— 构建时这些内容不会进入最终二进制

基准测试和示例测试也要遵守命名规则吗？

要。它们共享同一套文件识别机制：

• 基准测试函数必须写在 _test.go 文件中，函数名以 B

  

  enchmark 开头，签名是 func BenchmarkXxx(b *testing.B)
• 示例测试函数同样必须在 _test.go 文件中，函数名以 Example 开头，签名是 func ExampleXxx()（可选加 Output: 注释）
• go test -run 默认只跑 Test 函数；用 -bench 或 -example 才会触发对应类型 —— 但前提是文件名合规，否则连编译都不会纳入

最容易被忽略的是：子目录里的 _test.go 不会自动被上层 go test ./... 扫到，除非子目录本身是独立包（含 go.mod）或你显式指定路径。测试组织不是靠目录结构“自动发现”，而是靠 go test 的包解析逻辑和文件名硬规则共同决定的。