首先在有网环境下载依赖并复制缓存，再通过配置GOPROXY指向本地文件系统实现离线开发。具体步骤：1. 联网机使用go mod tidy下载依赖并打包$GOPATH/pkg/mod；2. 将缓存拷贝至离线机对应路径；3. 设置GOPROXY=file:///path/to/cache,direct；4. 可选搭建内部代理服务如Athens；5. 验证构建是否成功。需注意Go版本兼容、模块版本匹配及定期更新缓存，确保离线环境稳定依赖管理。
在某些企业内网或无法访问公网的环境中，搭建 Go Module 的离线开发环境是必要的。Go 1.11 引入了 Go Modules，使得依赖管理更加灵活，但也对网络提出了要求。本文介绍如何在无外网访问权限的环境下，搭建稳定可用的 Golang 离线开发环境。
1. 准备本地模块缓存（Module Cache）
Go Modules 的核心机制是通过 go mod download 下载依赖到本地缓存目录（默认为 $GOPATH/pkg/mod）。我们可以在有网络的机器上预先下载所需依赖，再将缓存复制到离线环境。
操作步骤：
- 在联网机器上初始化项目并触发依赖下载
- 使用 go mod tidy 自动分析并下载所有需要的模块
- 确认 $GOPATH/pkg/mod 目录包含完整依赖
- 将整个 mod 目录打包，拷贝至目标离线机器对应路径
2. 配置 GOPROXY 指向本地文件系统
从 Go 1.13 开始，GOPROXY 支持 file:// 协议，可用于指向本地模块仓库。
立即学习“go语言免费学习笔记（深入）”；
设置方式：
- 将已缓存的模块目录作为本地代理根目录，例如：/path/to/local/module/cache
- 配置环境变量：
export GOPROXY=file:///path/to/local/module/cache,direct - 注意：file 协议必须以三个斜杠开始（file:///），且路径需为绝对路径
这样当执行 go build 或 go mod download 时，Go 工具链会优先尝试从该本地路径查找模块。
3. 使用私有模块镜像服务（可选）
若团队多人使用，推荐搭建内部模块代理服务，如：
- JFrog Artifactory：支持 Go Module 代理与缓存
- Axway Repository Manager：提供 Go 模块支持
- goproxy.io 或 Athens：开源 Go module proxy 实现
部署后，在离线环境中设置：
export GOPROXY=http://your-internal-proxy
即可统一获取模块，避免每台机器单独同步缓存。
4. 离线环境验证与注意事项
完成配置后，进行以下验证：
- 新建一个测试项目，执行 go mod init testmod
- 添加一个曾缓存过的依赖，运行 go build
- 确认不报“cannot download”错误，且能正常编译
注意事项：
- 确保离线机器的 Go 版本与缓存生成环境一致或兼容
- 模块版本要精确匹配，避免因 minor 或 patch 版本差异导致重新下载失败
- 若使用 replace 替换本地路径，可在 go.mod 中临时指向 vendor 或本地目录
- 定期更新本地缓存包，同步新依赖需求
基本上就这些。只要提前准备好模块缓存，并正确配置 GOPROXY 指向本地源，就能在无网环境中流畅使用 Go Modules。关键是“先缓存、后迁移、再代理”的思路，适用于大多数封闭网络场景。
