ci中必须显式设置go111module=on，执行go mod tidy和go mod verify校验依赖一致性，禁用go.sum自动更新，分离docker多阶段构建中的模块下载，并确保工作目录为项目根目录。
CI 环境里直接复用本地 Go 配置（比如 GOPATH、GOROOT、全局 go env -w）几乎必然出错。标准做法是：不依赖宿主机环境，每次 CI 运行都从干净状态开始，靠显式配置 + 模块隔离保证可重现性。
go mod tidy 必须在 go test 前执行，且不能跳过
CI 中 go test ./ 失败的最常见原因是模块依赖不一致——本地有缓存、CI 里没下载完、或 go.mod 和实际导入路径对不上。CI 步骤里不能假设 go.sum 已存在或已校验。
- 必须先运行
go mod tidy，它会同步go.mod和go.sum，并清理未使用的依赖 - 紧接着加一步
go mod verify，验证所有模块哈希是否匹配官方 checksum 数据库（GOSUMDB） - 若项目含
vendor/目录，还需加go mod vendor -v并比对vendor/modules.txt是否与go.mod一致 - 禁止用
go get在 CI 中动态拉包——它绕过go.mod声明，破坏可重现性
GO111MODULE=on 不是默认值，必须显式设置
GitHub Actions 的 setup-go 默认开启模块模式，但 Jenkins、GitLab CI 或自建 runner 上，GO111MODULE 很可能仍是 auto 或 off，尤其当系统里残留旧版 Go 或 GOPATH 下有代码时。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 所有 CI 脚本开头加
export GO111MODULE=on，别依赖文档说“默认开启” - 确保工作目录就是
go.mod所在根目录——actions/checkout@v4默认做到这点，但 Jenkins 的Checkout步骤常需手动指定submodule: true或clean: true -
go test ./仅扫描当前模块内包；若误在子目录触发，会报import path not found；统一用cd $GITHUB_WORKSPACE（或对应变量）兜底
无缓存编译：禁用 $GOPATH/pkg/mod 缓存，但保留构建中间产物可控性
“无缓存”不是指完全不用磁盘加速，而是避免因缓存污染导致构建结果不一致。模块缓存（$GOPATH/pkg/mod）本身是安全的，但 CI 中若混用多个分支、tag 或不同 Go 版本，缓存可能交叉污染。
- GitHub Actions 推荐用
actions/cache@v4缓存~/.cache/go-build（Go 构建缓存），而非$GOPATH/pkg/mod；后者由go mod download控制，更稳定 - Jenkins 中若用
sh 'go build'，务必加CGO_ENABLED=0 GOOS=linux go build -trimpath -ldflags="-s -w"，其中-trimpath可避免绝对路径写入二进制，让构建结果真正与路径无关 - 禁止在 CI 中执行
go clean -modcache——它清的是本地开发者机器上的模块缓存，CI runner 本就不该有持久化模块缓存 - 真正要“无缓存编译”的场景，是调试构建失败时临时关闭缓存：在
go build后加-a参数强制重编所有依赖，但仅用于诊断，不可进主流程
交叉编译产物体积失控？关键在 -ldflags 和 CGO_ENABLED
CI 产出的 Linux 二进制动辄 20MB+，不是 Go 本身问题，而是默认链接了调试符号和反射元数据，且未禁用 CGO。
- 必须加
-ldflags="-s -w"：去掉符号表和 DWARF 调试信息，体积直降 60%~70% - 必须设
CGO_ENABLED=0：否则链接 glibc，导致无法在scratch或distroless镜像中运行 -
GOOS=linux GOARCH=amd64 go build -o myapp .是安全的；但若项目用了cgo（如 sqlite、openssl），就得换方案：要么改用纯 Go 实现（如mattn/go-sqlite3的_cgotag），要么在 builder 阶段用golang:alpine配合apk add gcc musl-dev - 验证是否成功：
file myapp应显示statically linked；ls -lh myapp应 ≤ 12MB（无 CGO 时）
最容易被忽略的一点：CI 流程里 go mod verify 和 go list -m all 这类校验命令，看似冗余，实则是防止依赖被镜像源篡改或代理劫持的最后一道防线——尤其当团队使用私有代理或国内镜像时，checksum 不匹配可能悄无声息地放过恶意包。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
