直接将常用模块打入基础镜像不可行，因为go不会自动读取预装模块，go mod download仍会联网拉取；必须通过builder镜像预热依赖、显式设置goproxy=direct、go111module=on，并确保go.sum完整和缓存路径可读，三者缺一不可。
直接把常用模块打进基础镜像不可行——Go 不会从镜像里自动读取预装的模块，go mod download 仍会尝试联网拉取，除非你彻底绕过模块缓存机制并强制复用本地路径。
为什么不能简单 COPY pkg/mod/cache 进基础镜像
Go 的模块缓存路径（$GOPATH/pkg/mod/cache）是运行时动态解析的，不是构建时静态加载的。即使你把整个 pkg/mod/cache 拷进镜像，只要没设对环境变量或没禁用代理，go build 或 go mod download 依然会走网络请求，甚至因校验失败而拒绝使用本地缓存。
-
go mod download默认校验sum.golang.org或代理提供的 checksum，离线时校验失败就中断 - 镜像中未设置
GOPROXY=direct，Go 仍会尝试连接https://goproxy.cn等地址 - 未同步
go.sum文件或含replace条目时，缓存内容可能被忽略
真正可行的方案：用 builder 镜像预热 + 多阶段 COPY
所谓“私有基础镜像”不是指把模块塞进 FROM golang:xxx，而是构建一个带完整依赖树的 builder 镜像，再在后续项目中复用它作为构建阶段来源。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 准备一个空目录，只放
go.mod和go.sum（内容是你所有项目共用的通用依赖，比如github.com/sirupsen/logrus、golang.org/x/net等） - 在有网机器执行：
GOOS=linux GOARCH=amd64 go mod download -json > deps.json，核对模块列表 - Dockerfile 中显式指定
ENV GOPROXY=direct，然后RUN go mod download -
docker build -t my-golang-builder .打包成 builder 镜像 - 其他项目 Dockerfile 第一阶段写成：
FROM my-golang-builder AS builder，跳过下载步骤
关键参数和易错点
不设对这几个值，预热就白做了。
-
GOPROXY=direct必须在go mod download前生效，否则仍发 HTTP 请求 -
GO111MODULE=on要显式设，避免某些旧脚本误启 GOPATH 模式 -
go.sum必须完整提交，尤其含// indirect的行——缺失会导致go mod download重新拉取并失败 - 如果项目用了
replace，builder 镜像里也得有对应代码路径，否则go build会报no matching versions
离线构建时怎么验证模块真被用了
别信日志里 “cached” 字样，要实锤。
- 构建时加
-v参数：go build -v .，看输出里是否出现find dir in cache类提示 - 临时删掉
go.sum，如果构建立刻失败（报 checksum mismatch），说明之前确实在用缓存校验 - 进容器执行：
ls -l $(go env GOMODCACHE)/github.com/sirupsen/logrus@v1.9.3，确认路径存在且非空
最麻烦的不是打包，而是让 Go 相信“这些模块可信且可用”——它不靠文件存在，而靠 go.sum 校验 + GOPROXY=direct + 缓存路径可读三者同时成立。少一个，就会默默连网或报错。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
