在有网环境执行go mod download下载并缓存依赖至$GOPATH/pkg/mod；2. 将缓存目录打包复制到离线机器并解压；3. 离线机设置GOproxy=off和GOSUMDB=off避免联网；4. 直接go build或run即可离线构建，前提是依赖已完整缓存。

在golang中使用go mod download进行离线安装，核心在于提前下载依赖并缓存到本地，之后在无网络环境下利用Go模块缓存来构建项目。虽然go mod download本身需要网络连接来首次获取模块，但可以通过合理操作实现“离线安装”的目标。

1. 在有网环境预下载依赖

在可以联网的机器上，进入你的Go项目根目录（包含go.mod文件），执行：

go mod download

这条命令会：

立即学习“go语言免费学习笔记（深入）”；

• 解析go.mod中的依赖
• 下载所有模块到本地模块缓存（默认在$GOPATH/pkg/mod）
• 同时也会下载校验信息到go.sum

确保所有依赖都已完整下载。你也可以用以下命令列出将要下载的模块：

go list -m all

2. 复制模块缓存到离线环境

将整个模块缓存目录打包复制到目标离线机器。通常路径为：

$GOPATH/pkg/mod

例如：

<font face="monospace">tar -czf gomodules.tar.gz -C $GOPATH/pkg mod # 然后拷贝到离线机器并解压 tar -xzf gomodules.tar.gz -C $GOPATH/pkg</font>

确保离线机器的GOPATH与打包时一致，或手动调整路径。

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

27

查看详情

3. 配置Go环境以支持离线使用

在离线机器上，设置Go的环境变量，避免尝试访问网络：

• GOPROXY=off：禁用代理，强制从本地查找
• GOSUMDB=off：关闭校验数据库，在离线时避免报错（注意安全风险）

设置方式：

go env -w GOPROXY=off
go env -w GOSUMDB=off

这样Go工具链就不会尝试从远程获取模块或校验和。

4. 离线构建和运行

进入项目目录后，直接运行：

go build 或 go run main.go

只要所有依赖已在pkg/mod中存在，Go会直接使用缓存模块，无需网络。

如果遇到缺失模块的错误，说明缓存不完整，需回到联网环境重新执行go mod download并确认go.mod无遗漏。

基本上就这些。关键点是提前把模块下载好，并把缓存带到离线环境，再通过配置避免Go去联网验证。虽然不能真正“离线执行download”，但能实现离线开发和构建的目标。