go test 稳定运行需强制指定 -timeout=60s、-p=1、-v 三个参数，多平台测试依赖 CI 矩阵而非 GOOS，外部依赖须动态启动并验证就绪，覆盖率与断言需可量化拦截。
go test 本身不提供“配置”入口，所谓“配置自动化测试”，本质是控制执行环境、约束行为、隔离依赖、统一输出——不是改某个开关，而是组合命令参数、CI 策略和代码结构。
go test 命令必须加的三个参数
CI 中裸跑go test 极易失控：超时卡死、并发干扰、日志缺失。稳定运行的前提是显式声明行为边界：
• -timeout=60s：防止 HTTP client 等阻塞操作无限等待，尤其在 CI runner 资源受限时；
• -p=1：禁用并行，排除竞态干扰（如共享内存 DB、临时文件冲突）；
• -v：强制详细输出，失败时能立刻看到是哪个子测试、哪行断言挂了；
立即学习“go语言免费学习笔记（深入）”；
别用 -race 全局开启——它吃内存严重，GitHub-hosted runner 容易 OOM；只在专用 job 中对关键包启用，例如 go test -race ./pkg/auth/...。
多平台测试必须靠 CI 矩阵，不是靠 GOOS
go test 永远只在当前 runtime 下运行，设置 GOOS=windows 在 macOS 上不会让测试跑出 Windows 行为，只会导致构建失败或 syscall panic。
• GitHub Actions 中正确做法是用 matrix 启动不同 OS 的 runner：os: [ubuntu-latest, windows-latest, macos-latest]；
• 每个 job 内无需手动设 GOOS 或 GOARCH——runner 自带对应平台 Go 环境，go version 输出已体现；
• 若需验证 linux/arm64，必须用 runs-on: ubuntu-22.04-arm64，不能靠 GOARCH=arm64 在 x86 机器上“模拟”；
平台相关逻辑（如路径分隔符、os.OpenFile 标志、syscall 调用）必须用构建标签（//go:build windows）隔离，否则测试在非目标平台直接 panic。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
外部依赖必须启动即销毁，不能假定 localhost 可用
微服务或集成测试中，硬编码localhost:5432 或 redis://localhost:6379 是 CI 失败主因——本地有 Redis，CI 没启，测试秒 panic。
• 用 testcontainers-go 启临时容器，测试结束自动清理，避免端口冲突和状态残留；
• PostgreSQL 容器必须等日志出现 database system is ready to accept connections 才算就绪，不能 time.Sleep(3 * time.Second)；
• 数据库连接字符串指向内存 SQLite（sqlite3://:memory:）或容器映射端口（container.MappedPort），绝不写死；
• HTTP 服务测试优先用 httptest.NewUnstartedServer 或绑定 localhost:0，由系统分配空闲端口，避免 address already in use。
覆盖率与断言要可验证、可拦截
覆盖率数字本身无意义，关键在于是否覆盖 error path 和边界条件，且 CI 必须能据此阻断低质量提交。• 用 -covermode=count -coverprofile=coverage.out 生成计数型 profile，支持跨包聚合；
• CI 中用 go tool cover -func=coverage.out | grep "total:" 提取总覆盖率，再用 grep -q 'total.*80\.0%' 校验阈值，不达标则 exit 1；
• 断言别用原生 if err != nil { t.Fatal() } 堆砌，改用 gomega 链式表达意图，例如 Expect(resp.Status).To(Equal(pb.ORDER_CONFIRMED))；
• 异步场景（如发消息后查 DB）必须用 Eventually 轮询，不能 time.Sleep 后硬断言——失败时无法区分是延迟还是逻辑错。
真正难的不是写 TestXxx 函数，而是让每个测试在任意平台、任意时间、任意并发节奏下，都表现出确定性行为——这要求你从第一行 setup 就放弃“本地能跑就行”的假设。
