GitHub Actions 中配置 Go CI 需显式指定 go version（如1.21.x），启用 actions/cache@v4 缓存模块与构建目录，先 run go mod download 再测试，推荐 matrix 测试多版本但生产固定主版本；本地与 CI 不一致时需检查 //go:build 标签、GOOS/GOARCH、临时路径、外部服务 mock；建议拆分为 lint/test/build 并行 job，用 golangci-lint 二进制安装、go test -coverprofile 生成覆盖率并 codecov-action 上传，go build 加 -ldflags="-s -w"，交叉编译用 GOOS/GOARCH；私有模块需设 GOPRIVATE、git config insteadOf 或 ~/.netrc 凭据注入，密钥通过 secrets 安全注入。
GitHub Actions 中如何配置 Go 的基础 CI 流程
Go 项目用 GitHub Actions 做 CI 最轻量、最直接，无需额外维护服务器。关键不是“能不能跑”，而是环境版本、模块校验、缓存策略是否合理。
-
go version必须显式指定，比如1.21.x，避免默认用最新版导致go.sum不一致或依赖解析失败 - 启用
actions/cache@v4缓存$HOME/go/pkg/mod和$HOME/go/build-cache，能减少 60%+ 构建时间 - 必须运行
go mod download后再执行测试，否则并发测试可能因模块未预加载而超时或失败 - 推荐在
matrix中测试多个 Go 版本（如1.20、1.21），但生产构建只固定一个主版本，避免误用实验性特性
本地 go test 和 CI 中行为不一致怎么办
CI 失败但本地通过，90% 是环境差异或隐式依赖导致的，不是代码问题。
- 检查是否用了
//go:build标签但没在 CI 的go test命令里传-tags，比如go test -tags=integration ./... - 确认
GOOS/GOARCH是否被硬编码，默认 CI 是linux/amd64，若本地在 macOS 测试了syscall相关逻辑，CI 会 panic - 临时文件路径写死（如
/tmp/xxx）在 CI 可能权限不足，应改用os.MkdirTemp("", "test-") - 数据库或外部服务依赖未 mock，CI 环境无
redis或postgres，需用docker-compose或setup-postgres等 action 启动容器
如何让 CI 同时做构建、静态检查和覆盖率上传
把多个职责塞进一个 job 容易失控，建议拆成 lint、test、build 三个并行 job，靠 needs 控制依赖关系。
-
golangci-lint推荐用二进制安装（curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin v1.54.2），比go install更稳定 - 覆盖率建议用
go test -coverprofile=coverage.out -covermode=count ./...生成，再用codecov-action@v3上传；注意coverage.out路径要和上传动作中指定的一致 -
go build阶段别漏掉-ldflags="-s -w"去除调试信息，否则二进制体积大、启动慢，且可能暴露构建路径等敏感信息 - 交叉编译多平台产物（如
linux/arm64）要用GOOS=linux GOARCH=arm64 go build，不能只靠buildx，后者对 Go 的 CGO 支持不稳定
私有模块（如 GitLab / 自建 Nexus）在 CI 中如何认证
Go 拉取私有模块失败，错误通常是 go: github.com/xxx/yyy: module github.com/xxx/yyy: reading https://api.github.com/repos/xxx/yyy/commits/HEAD: 404 Not Found 或 401 Unauthorized，本质是认证缺失或 GOPRIVATE 配置错位。
立即学习“go语言免费学习笔记（深入）”；
- 必须在 CI step 开头设置
GOPRIVATE=gitlab.example.com/*,nexus.example.com/*，否则 Go 默认走 proxy.golang.org，绕过私有源 - GitLab 私有库需配置
git config --global url."https://oauth2:${{ secrets.GITLAB_TOKEN }}@gitlab.example.com".insteadOf "https://gitlab.example.com" - Nexus 或 Artifactory 需配合
~/.netrc文件注入凭据，用echo "machine nexus.example.com login ${NEXUS_USER} password ${NEXUS_PASS}" > ~/.netrc写入 - 避免把 token 硬编码在
go.mod里，CI 中用secrets注入，并确保 workflow 权限设为permissions: contents: read即可，无需secrets: read（除非真要读其他仓库密钥）
实际跑通一个 Go CI，最难的从来不是写 YAML，而是让 go mod download 不卡住、go test 不因环境变量或时区挂掉、私有依赖不因 GOPRIVATE 漏配而静默 fallback 到 public proxy。这些点不提前压测，上线前一小时准出问题。
