单元测试只测函数逻辑、隔离外部依赖，集成测试连真实依赖但需可控可销毁；二者通过构建标签//go:build integration严格分离，子测试t.Run组织多场景用例并确保独立性。
单元测试只测函数逻辑，不碰数据库和网络
单元测试的目标是验证单个函数或 handler 的输入输出是否符合预期，比如 Add 返回正确值、ValidateUser 在邮箱格式错误时返回 ErrInvalidEmail。它必须隔离外部依赖——数据库连接、HTTP 客户端、文件读写统统不能出现。
常见错误现象：TestCreateUser 直接调用真实 PostgreSQL 插入数据，结果本地没装数据库就 panic；或测试里用了全局 http.DefaultClient，导致并发测试互相干扰。
- 用 interface 抽象依赖（如
type UserRepository interface { Save(*User) error }），测试时注入 mock 实现 - HTTP handler 测试优先用
httptest.NewRequest+httptest.NewRecorder，不启动真实 server - 避免在测试中 sleep 等待异步操作完成；改用 channel 或
sync.WaitGroup显式同步
集成测试要连真实依赖，但得可控、可销毁
集成测试不是“把整个服务 docker run 起来再 curl”，而是启动最小闭环：一个带真实 SQLite 内存库的 HTTP server，加一个干净的 http.Client 发请求。它要暴露单元测试发现不了的问题，比如 JSON tag 拼错导致字段为空、事务未提交、SQL 注入过滤失效。
常见错误现象：go test 运行时突然连上生产数据库；多个测试共用同一张表导致数据污染；忘记关闭 test container 导致端口被占。
- 数据库首选
"sqlite3://:memory:"或testcontainers-go启临时 PostgreSQL 容器 - 集成测试文件统一命名为
*_integration_test.go，开头加构建标签：//go:build integration - 用
TestMain统一管理资源生命周期：启动容器 → 运行测试 → 清理容器
用 go test -tags=integration 隔离两类测试
默认 go test 只跑单元测试；集成测试必须显式启用标签，否则 CI 里误跑会拖慢反馈、污染环境。Go 不支持运
参数差异：go test ./... -v 不会执行带 //go:build integration 的文件；而 go test -tags=integration ./... 会跳过所有无该标签的测试。
- 别在单元测试里用
os.Setenv("ENV", "test")模拟集成环境——这属于混淆职责 - CI 中建议分两阶段：先
go test ./...，再go test -tags=integration ./... - 本地开发时，可用 Makefile 封装：
make test-unit和make test-integration
子测试 t.Run 是组织 API 多场景用例的唯一合理方式
同一个 API 接口要测成功、400、401、500 多种响应，不用 t.Run 就只能写一堆重复 setup/teardown，或者用全局变量污染状态。Go 原生支持子测试，且能独立失败、独立计时、独立标记。
容易踩的坑：在 t.Run 闭包里直接用循环变量 tt，导致所有子测试都拿到最后一个值；或在子测试里用 t.Fatal 导致后续用例跳过。
- 务必用
tt := tt捕获循环变量（Go 1.22+ 支持 range 闭包自动绑定，但老版本仍需显式复制） - 子测试内只用
t.Errorf/t.Logf，不要用t.Fatal—— 它会让整个测试函数退出 - 命名带语义：
t.Run("returns_401_when_token_missing", func(t *testing.T) { ... })
