go mod download 依然慢是因为即使配置 GOPROXY，仍需走完整 HTTP 请求流程；真正秒级需用 file:// 协议直读本地合规模块目录，且必须预热、权限正确、路径绝对，否则报错不降级。
为什么 go mod download 依然慢，即使配置了 GOPROXY？
本地镜像不是设个 GOPROXY=http://localhost:8080 就自动秒下——Go 客户端仍会向代理发起完整 HTTP 请求，走网络栈、DNS 解析、TLS 握手；如果本地镜像服务没做缓存预热、没绕过校验或没启用响应压缩，实际耗时和远端代理差别不大。
真正实现“秒级”，核心是让 go mod download 读取本地文件系统而非发 HTTP 请求。Go 1.13+ 支持 file:// 协议代理，但必须满足两个硬条件：目录结构严格遵循 /$module/@v/$version.info 等 Go Module Mirror 规范，且所有 .info/.mod/.zip 文件必须存在（不能靠运行时代理生成）。
- 用
goproxy.cn或proxy.golang.org作GOPROXY时，下载路径是动态代理转发，无法跳过网络 I/O -
file://路径必须绝对、可读，且 Go 进程有权限访问（例如 Docker 容器里挂载路径不匹配就 404） - 首次构建时若模块未预热，
file://会直接报错not found，不会 fallback 到其他 proxy
用 athens 搭建可预热的本地 Go 代理服务
Athens 是少数支持离线预热 + 本地磁盘存储的 Go module proxy 实现，它把模块存为标准布局的文件树，同时暴露 HTTP 接口，既能当真实代理用，也能导出为 file:// 路径供直读。
关键操作不是启动就完事，而是提前把高频依赖 dump 下来：
- 启动时加
-cache-folder /data/athens/storage明确指定存储路径 - 用
curl -X POST http://localhost:3000/admin/v1/sync?module=github.com/gin-gonic/gin@v1.9.1主动触发单模块同步（避免首次 build 时阻塞） - 批量预热推荐用
athens proxy sync工具，配合go list -m all输出的模块列表 - 导出为 file 协议前，确认
/data/athens/storage下已有github.com/gin-gonic/gin/@v/v1.9.1.info等完整文件
直接用 file:// + 预生成模块存储目录
跳过代理服务，直接构造合规的本地模块仓库，是最轻量也最容易失控的方式。Go 官方 go mod download -json 可导出模块元信息，但不生成 .zip；必须用 go mod download -json | jq -r '.Path + "@" + .Version' | xargs -I{} go mod download {} 触发下载，再手动整理目录结构。
更可靠的做法是复用 Athens 的存储格式（它完全兼容 Go 官方 layout）：
- 把 Athens 的
storage/目录整体拷贝到/opt/go-proxy-cache - 设置
GOPROXY=file:///opt/go-proxy-cache（注意三个斜杠） - 验证：运行
go mod download github.com/spf13/cobra@v1.7.0，看是否秒返回且无 HTTP 日志 - 常见坑：
file://路径含空格或中文会失败；macOS 上~/path不被识别，必须用/Users/xxx/path
CI 场景下如何稳定复用本地镜像缓存
Docker 构建或 GitHub Actions 中，“本地镜像”本质是镜像层或 runner 本地磁盘，但每次 job 启动都是干净环境，预热缓存极易丢失。
- GitHub Actions：用
actions/cache缓存$(go env GOCACHE)不够——GOCACHE 存的是编译产物，不是 module 源码；必须缓存整个file://目录（如~/.athens-storage） - Docker：在
Dockerfile中 COPY 预构建好的storage/目录，并在ENV GOPROXY=file:///go-proxy前确保该路径已存在且非空 - 多项目共用同一缓存时，注意不同 Go 版本对 module checksum 的校验逻辑可能不同，建议按
GOVERSION分目录隔离
最易被忽略的一点：Go 不会校验 file:// 下的 .sum 文件是否匹配——它默认信任本地文件，所以预热时若中途断电或磁盘损坏，后续构建可能静默失败，没有错误提示。
