正确配置go环境并启用Modules是使用go get的前提。需安装Go并设置GOROOT、GOPATH和PATH;在项目根目录执行go mod init初始化模块;通过go get下载依赖,建议配置GOproxy代理如https://goproxy.cn以加速国内下载;遇到问题时检查包名、代理设置及权限。

使用 go get 下载和管理依赖是 golang 开发中的基本操作。要让 go get 正常工作,需要正确配置 Go 的开发环境,并理解模块(Go Modules)的工作机制。以下是完整的环境配置与依赖管理指南。
1. 安装 Go 并设置基础环境变量
确保已安装 Go 并配置好核心环境变量:
- 从 https://www.php.cn/link/3459bf8c8dd0d6bf12f741d85ebd41c0 下载并安装对应系统的 Go 版本(建议 1.16+)
- 安装完成后,验证版本:
go version - 设置以下环境变量(linux/macOS 在 ~/.bashrc 或 ~/.zshrc 中配置;windows 在系统环境变量中设置):
GOROOT: Go 的安装路径,例如 /usr/local/go
GOPATH: 工作空间路径,例如 ~/go(默认值)
PATH: 添加 $GOROOT/bin 和 $GOPATH/bin 到 PATH
示例(Linux/macOS):
export GOROOT=/usr/local/go export GOPATH=$HOME/go export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
运行 source ~/.bashrc 使配置生效。
立即学习“go语言免费学习笔记(深入)”;
2. 启用 Go Modules(推荐方式)
Go 1.11 引入了 Modules,取代旧的 GOPATH 模式。现在推荐始终使用 Modules 管理依赖。
- 在项目根目录执行:
go mod init 项目名
例如:go mod init myapp - 之后使用
go get会自动写入 go.mod 和 go.sum 文件 - 无需将项目放在 GOPATH 目录下
常用命令:
-
go get package_name:下载并添加依赖 -
go get -u:更新已有依赖 -
go get package@version:指定版本,如go get github.com/gin-gonic/gin@v1.9.1
3. 配置代理以加速国内下载
由于网络问题,国内访问 golang.org 等域名可能失败。需配置代理:
- 设置 GOPROXY 使用公共代理:
go env -w GOPROXY=https://proxy.golang.org,direct
推荐使用七牛云代理(更快更稳定):
go env -w GOPROXY=https://goproxy.cn,direct
- 如果公司内网限制,可临时关闭校验:
go env -w GOSUMDB=off
注意:关闭 sumdb 仅用于调试,生产环境建议保持开启。
4. 常见问题与解决方法
遇到 go get 失败时,可按以下方式排查:
- 错误:cannot find package —— 检查包名是否正确,是否启用 Modules
- 超时或连接失败 —— 确认 GOPROXY 设置正确,尝试更换代理
- 证书问题 —— 更新系统时间,或设置
GOINSECURE忽略特定域名验证 - 权限问题 —— 确保 GOPATH 路径有读写权限
基本上就这些。只要 Go 安装正确、启用 Modules 并配置好代理,go get 就能顺利下载依赖。现代 Go 开发不再依赖复杂的目录结构,模块化让依赖管理变得简单可靠。