go test 在 CI 中必须启用 -race -timeout 30s -count=1 ./... 组合：开启竞态检测、防止卡死、禁用缓存、递归覆盖全部子模块。
go test 在 CI 中必须启用的参数组合
CI 环境下仅运行 go test 默认行为极易漏掉关键问题。默认不执行测试覆盖率、不捕获 panic、不超时控制，且忽略子目录中未显式导入的测试包。
-
-race必须开启：CI 是检测竞态条件最可靠的环境，本地开发常因调度偶然性逃逸 -
-timeout 30s强制设限：防止某个测试卡死阻塞整个流水线（尤其涉及网络、time.Sleep 或 channel 等待） -
-count=1禁用缓存：避免因测试间状态残留（如全局变量、临时文件、mock 时间）导致 flaky 测试被误判为稳定 -
./...而非.：确保递归覆盖所有子模块，包括internal/和cmd/下的测试
生成可被 CI 工具解析的测试报告格式
多数 CI 平台（GitHub Actions、GitLab CI、Jenkins）不直接理解 go test 原生输出，需转为标准 XML 格式。
原生 go test 不支持 XML 输出，必须借助第三方工具。推荐使用 gotestsum —— 它轻量、无依赖、输出稳定，且兼容 Go 模块：
go install gotest.tools/gotestsum@latest gotestsum -- -race -timeout 30s -count=1
若需集成到 GitHub Actions，可指定 --format testname 或 --json，再配合 actions/setup-go 的缓存机制避免重复安装。
注意：gocov 或 goveralls 类工具已过时，Go 1.20+ 原生 go test -coverprofile + go tool cover 即可完成覆盖率提取，无需额外二进制。
在 GitHub Actions 中安全运行 go test 的最小可行配置
常见错误是直接复用本地 go test 命令，忽略 CI 环境的隔离性与权限限制。
- 工作目录必须显式设置为仓库根路径：
working-directory: . - Go 版本应锁定（如
1.22），避免因 GitHub 默认版本升级导致go mod download失败 - 禁用 GOPROXY=direct 以外的代理：CI 内网通常无法访问私有 proxy，且
https://proxy.golang.org在部分区域不稳定 - 测试前必须运行
go mod download：防止并发下载触发 rate limit 或超时
一个精简但健壮的 job 示例：
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-go@v5
with:
go-version: '1.22'
- run: go mod download
- run: gotestsum -- -race -timeout 30s -count=1 ./...
env:
GOPROXY: direct
go test 与 CI 工具协同时最容易被忽略的陷阱
很多团队把测试通过当成终点，但 CI 中真正的失败往往藏在「看似成功」的边缘场景里。
-
go test返回码为 0 并不等于「所有测试都跑完了」——若go list ./...阶段出错（例如 import 循环、go.mod 语法错误），go test可能静默跳过全部包，只打印 warning 后退出 0 - 覆盖率统计必须用
go tool cover -func解析cover.out，不能依赖gotestsum的 summary 行：后者只统计当前命令执行的包，不合并多轮测试结果 - 自定义
TestMain中调用os.Exit(0)会绕过go test的结果判断，导致 CI 认为测试成功，实际未执行任何子测试 - CGO_ENABLED=1 时，不同平台编译的 C 依赖（如 sqlite3）在 CI 容器中大概率缺失，应统一设为
CGO_ENABLED=0除非明确需要
这些点不会报错，但会让 CI 失去意义——它看起来在运行测试，其实什么也没验证。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
