必须先确保go.mod和go.sum存在且完整，否则跳过下载会导致build失败或依赖不一致；Docker中COPY顺序不当、go.sum未提交或校验失败均会触发重复下载。
直接跳过模块下载是可行的，但必须满足前提：go.mod 和 go.sum 已存在且内容完整，且构建上下文里没有修改它们。 否则跳过会导致 go build 失败或拉取不一致的依赖版本。
为什么 go mod download 会被反复触发
常见错误是把 COPY . . 放在 go mod download 前面，导致每次源码变更都让前面所有层缓存失效；或者 go.mod 被 Git 忽略、CI 环境没提交 go.sum，容器内检测到缺失就自动回退到下载流程。
- Docker 构建时，只要某一层的输入文件（如
go.mod）内容变了，它和之后所有层都会重建 -
go build在模块模式下会隐式检查go.sum完整性，缺字段、校验和不匹配、或go.mod有未 tidy 的 import，都会触发下载 - CI 流水线若用
go mod vendor但没配-v或没清理旧 vendor，go mod tidy可能误判依赖状态
如何真正跳过下载：三步确认法
不是加个 --no-download 参数（Go 没这选项），而是让 Go 工具链“认为没必要下”。关键动作是验证并固化依赖快照。
- 本地开发完后，必须运行
go mod tidy，确保go.mod和go.sum都已更新并提交到 Git - 在 Dockerfile 中，
COPY go.mod go.sum ./必须紧接在FROM golang:1.22之后，且早于任何COPY . . - 构建命令里显式加
GO111MODULE=on和GOSUMDB=off（仅限可信内网环境），避免因校验失败 fallback 下载
CI/CD 中跳过下载的实操配置
多数 CI 平台（GitHub Actions、GitLab CI）默认不缓存 $GOPATH/pkg/mod，所以不能依赖本地模块缓存。得靠镜像层 + 显式控制。
立即学习“go语言免费学习笔记（深入）”；
- 在
.dockerignore中排除node_modules/、vendor/、*.log，防止误触缓存失效 - 使用构建参数传递校验开关：
docker build --build-arg GOSUMDB=off -t myapp .，Dockerfile 中用ARG GOSUMDB+ENV GOSUMDB=$GOSUMDB - 若项目含私有模块，
GO111MODULE=on和GOPRIVATE=*.internal,git.corp.com必须同时生效，否则仍会尝试走代理并超时重试
最易被忽略的一点：即使 go.mod 没变，如果某依赖包在 go.sum 中记录的校验和与远程实际内容不一致（比如私有仓库被 force push 覆盖了 tag），Go 仍会拒绝构建并报错 checksum mismatch —— 此时跳过下载只会让错误更隐蔽，而不是更快。
