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文件中，函数名以Benchmark开头，签名是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 的包解析逻辑和文件名硬规则共同决定的。
