Go测试需命名_test.go、同包、Test开头函数；go test -v -coverprofile常用；依赖用接口抽象；无输出常因文件名/签名/包名错误。
Go 语言自带测试支持，不需要额外安装测试框架或运行环境——go test 命令开箱即用，但要真正高效写和跑单元测试，得理清几个关键配置点和常见陷阱。
如何命名和组织测试文件
Go 要求测试文件必须以 _test.go 结尾，且与被测代码放在同一包（同一目录）下。例如：calculator.go 对应的测试文件应命名为 calculator_test.go。
常见错误是把测试文件放到 test/ 子目录或单独建 test 包，这样 go test 会直接忽略——Go 不识别“测试目录”，只认文件名后缀和包归属。
- 测试函数必须以
Test开头，且接收单个*testing.T参数，如func TestAdd(t *testing.T) - 测试文件里可以定义非
Test*的辅助函数，但不能导出（首字母小写），否则go test可能报错 “can’t load package” - 如果想为多个包批量运行测试，需在项目根目录执行
go test ./...，而不是go test .
如何正确使用 go test 命令参数
go test 默认只运行当前目录下的测试，不递归、不编译主程序、也不生成覆盖率报告——这些都得靠参数显式开启。
立即学习“go语言免费学习笔记（深入）”；
最常用组合是：go test -v -coverprofile=coverage.out，其中：
-
-v显示每个测试函数的名称和输出，便于定位失败点 -
-cover打印覆盖率百分比；-coverprofile写入覆盖率数据供后续分析 -
-run支持正则匹配测试函数名，比如go test -run ^TestAdd$只跑TestAdd -
-count=1（默认值）避免重复运行；若设为-count=3，会连续跑三次（用于检测随机性 bug）
注意：go test 默认不会自动 rebuild 测试二进制，改了代码后必须重新执行命令，它不监听文件变化。
如何处理测试依赖（如数据库、HTTP 服务）
真实项目中，测试常需模拟外部依赖。Go 官方推荐接口抽象 + 依赖注入，而非全局替换或 monkey patch。
例如：被测函数依赖 *sql.DB，就应改为接收 DBExecutor 接口（含 QueryRow 等方法），测试时传入自定义的 mock 实现。
- 不要在测试中启动真实数据库，除非是集成测试且明确用
go test -tags=integration控制 - HTTP 服务模拟优先用
httptest.Server或httpmock（需引入第三方），避免硬编码localhost:8080 - 时间敏感逻辑（如超时、重试）应接受
time.Now或time.Sleep的可替换版本，否则难以断言和加速测试
为什么 go test 不报错却没运行任何测试
这是新手最常遇到的问题，典型现象是执行 go test 后只输出 ok example.com/mymodule 0.001s，但没看到 Test* 函数执行日志。
根本原因通常是：
- 测试文件不在当前目录，或文件名不是
_test.go（比如写成test.go或calculator_tests.go） - 测试函数签名错误：漏掉
*testing.T参数，或函数名不是TestXxx格式（testAdd或TESTADD都无效） - 测试文件属于另一个包（比如写了
package test），而 Go 要求测试文件和被测代码同包（package main或package calc） - 当前目录下没有
go.mod，且 GOPATH 模式未正确配置，导致模块解析失败
排查建议：先运行 go test -v，看是否列出测试函数名；再检查 go list -f '{{.TestGoFiles}}' . 输出是否包含你的测试文件。
