Go项目CI/CD无需apt/brew安装Go，因版本滞后或路径问题导致兼容风险；核心是确保缓存命中、竞态暴露、交叉编译可控、覆盖率可验，缺一即假稳定。
Go 环境不用 apt 或 brew 装，CI/CD 里会出兼容问题；自动化构建管道的核心不是“跑通”，而是缓存命中、竞态暴露、交叉编译可控、覆盖率可验 —— 这四点漏一个，CI 就是假稳定。
为什么不能用 apt install golang 或 brew install go
Ubuntu 官方源的 Go 版本通常滞后 2–3 个主版本（比如系统给 1.18，而当前稳定版已是 1.22）；Homebrew 虽较新，但把 Go 装到 /opt/homebrew/Cellar/go/1.22.0 这类路径下，go env GOROOT 指向子目录，升级时硬链接断裂，go install 带 @latest 会静默失效。所有自动化场景（Docker 构建、CI runner 初始化）必须统一用 https://go.dev/dl/ 发布的 tar.gz 包。
go mod download 缓存必须带 go.sum 哈希
默认每次 CI job 都重拉依赖，构建慢且易因网络抖动失败。必须用 actions/cache 缓存 $HOME/go/pkg/mod，但 key 写错就白搭：
- 正确写法：
key: cache-go-mod-${{ hashFiles('**/go.sum') }} - 错误写法：
key: cache-go-mod-${{ matrix.go-version }}（版本不变但go.sum改了，缓存仍命中） - 必须在
go build前显式执行go mod download，否则缓存不生效 - 别缓存整个
$HOME/go—— 它含GOPATH构建产物，会污染后续 job
go test -race 在 CI 中失败 ≠ 本地没测，而是调度更严苛
竞态检测器对 CPU 调度敏感，CI 环境资源受限、goroutine 切换更随机，本地跑过不等于线程安全。必须固定启用：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- CI 中强制加
-race参数，不能只在本地跑 - 避免用
time.Sleep模拟等待 —— race detector 会忽略 sleep，但实际仍可能竞争 - 确保
sync.WaitGroup的Wait()在所有Add()之后调用，且无 goroutine 泄漏 - 旧版
golang.org/x/net/http2（v0.17.x 及更早）自带竞态，需升到v0.18.0+
交叉编译前必须确认 CGO_ENABLED 和 C 工具链
GOOS=linux GOARCH=arm64 go build 生成不了可用二进制，常见原因不是参数错，而是环境没配齐：
- 纯静态二进制：设
CGO_ENABLED=0，免 libc 依赖，适合容器部署；但一旦用了 sqlite、openssl 等 cgo 库，就必须关掉该选项 - 启用 cgo 时：镜像必须含对应 C toolchain（如
gcc-aarch64-linux-gnu），推荐用golang:1.22-slim或debian:bookworm-slim，别用alpine（musl libc 不兼容） - 交叉编译前手动设
CC_arm64=arm64-linux-gnu-gcc，或用docker buildx替代裸GOOS/GOARCH -
CGO_ENABLED=0下net包 DNS 解析 fallback 到 Go 自实现，内网 DNS 配置行为可能和 libc 不同
真正难的不是写完 pipeline，而是每次 go.mod 小改后缓存是否真失效、-race 是否覆盖全部测试路径、CGO_ENABLED=0 下 DNS 是否在目标环境解析失败 —— 这些点不会报错，但上线后才露馅。
