如何在Golang中使用go mod download离线安装

在有网环境执行 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”，但能实现离线开发和构建的目标。