go test 开箱即用但需严格遵循规则：测试文件必须为 _test.go、与被测代码同目录同包；test 函数须以大写 test 开头、唯一参数为 testing.t；常用命令如 -v、-run、-coverprofile 等；外部依赖须接口抽象+依赖注入，配合 t.cleanup 清理资源。
go test 开箱即用，不需要装框架、不依赖外部工具——但跑不起来，90% 是因为文件名、包名或函数签名没对上。
测试文件命名和位置必须严格匹配
Go 只认 _test.go 后缀的文件，且必须和被测代码在**同一目录、同一包名下**。比如 calculator.go 在 pkg/calculator/ 目录，那测试文件就得叫 calculator_test.go，也放在 pkg/calculator/ 里，包声明仍是 package calculator。
常见错误：
- 把测试文件放进
test/子目录 ——go test完全无视 - 测试文件包名写成
package calculator_test—— 编译失败，提示 “no buildable Go source files” - 文件名拼错，比如
calculator.test.go或calculator_tests.go—— 不会被发现
Test 函数签名不能有任何偏差
每个测试函数必须以 Test 开头（首字母大写），且只接收一个参数：*testing.T。少一个星号、类型写成 testing.T 或 *testing.B，都会导致 go test 找不到该函数。
正确写法示例：
func TestAdd(t *testing.T) {
result := Add(2, 3)
if result != 5 {
t.Fatalf("expected 5, got %d", result)
}
}
注意：
- 函数名中间不能有下划线，
Test_Add不合法；但TestAddNumbers合法 - 可以定义辅助函数，但必须小写开头（如
setupDB()），否则go test会尝试运行它并报错 - 别在测试里用
log.Fatal或os.Exit—— 会直接终止整个测试进程，跳过后续用例
常用 go test 参数组合要记牢
默认 go test 只跑当前目录、静默执行、不输出覆盖率。真正在开发中用得上的命令是：
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
-
go test -v：显示每个测试函数名和t.Log输出，失败时立刻看到哪一行出问题 -
go test -v -run ^TestAdd$：正则精确匹配单个测试，避免改一个小函数就跑全量 -
go test -v -coverprofile=coverage.out ./...：递归扫描所有子包，生成覆盖率数据文件 -
go test -count=1：显式指定只跑一次（防止某些测试被意外重复执行）
特别注意：go test 不自动 rebuild —— 改完代码后必须重新执行命令，它不会监听文件变化。
依赖外部服务的测试必须解耦
数据库、HTTP 请求、时间相关逻辑，都不能在单元测试里真实调用。否则测试变慢、不稳定、还可能污染环境。
正确做法是抽象接口 + 依赖注入：
- 把
*sql.DB换成自定义接口，比如type DBExecutor interface { QueryRow(...) - HTTP 调用封装成接口，测试时传入
httptest.NewServer的*http.Client - 时间敏感逻辑接收
now func() time.Time参数，默认用time.Now，测试时传入固定时间
别用全局变量或单例初始化 DB/Client —— 那会让多个测试相互干扰，且无法单独 mock。
真正容易被忽略的是：即使你写了 mock，如果没在测试函数里显式调用 t.Cleanup() 关闭 server 或 reset 状态，下次测试可能拿到脏数据或端口冲突。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
