【go】初学者入门环境配置,GOPATH,GOROOT,GOCACHE,以及GoLand使用配置注意,ubuntu的go1.20安装配置
环境变量环境变量Win + Rsysdm.cplGOROOTGOPATHGOPATHsrcGOCACHEGOCACHE可以不配置,默认会存在这里,我的c盘紧缺,用到后面会占很多地方,所以配置到E盘go buildgo rungo versionfmt。
·
一、环境变量配置步骤
1. 打开环境变量设置
Win + R后输入sysdm.cpl→ 点击 确定- 在弹出窗口中点击 高级 → 环境变量
2. 配置 GOROOT(Go语言安装根目录)
- 作用:告诉系统Go语言的安装位置(编译器、标准库等核心文件所在路径)。
- 配置步骤:
- 在 系统变量 区域点击 新建
- 变量名:
GOROOT - 变量值:
D:\goSDK\go1.23.1(你的Go安装目录,这里添加一个上级目录,方便多版本管理) - 点击 确定
3. 配置 GOPATH(工作目录)
- 作用:存放你的Go项目代码src、依赖包pkg和编译结果bin。
- 配置步骤:
- 在 系统变量 区域点击 新建
- 变量名:
GOPATH - 变量值:
D:\code\GoLand(你的工作目录,建议设为项目存放位置) - 点击 确定
这里主要是bin目录和pkg目录的存放位置,不能动,必须在GOPATH下;通常,我们的项目代码src可以放在这里,自己在GOPATH下建一个src,里面就是项目目录,当然,src也可以不放在GOPATH下,任意位置都可以
- 目录结构:在
GOPATH(即D:\code\GoLand)下创建一个子目录src,另外俩会自己生成:D:\code\GoLand\ ├── src\ # 存放源代码(如项目文件夹) ├── pkg\ # 存放编译后的包文件(自动生成) └── bin\ # 存放编译后的可执行文件(自动生成)
4. 配置 GOCACHE(编译缓存目录)
- 作用:存放编译过程中的临时文件,加速后续编译(类似浏览器缓存)。
- 配置步骤:
- 在 系统变量 区域点击 新建
- 变量名:
GOCACHE - 变量值:
E:\GOCACHE\go-build(非系统盘的目录,节省C盘空间) - 点击 确定
GOCACHE可以不配置,默认会存在
C:\Users\用户名\AppData\Local\go-build这里,我的c盘紧缺,用到后面会占很多地方,所以配置到E盘
5. 更新 PATH 变量(重要!)
- 作用:让系统能够找到Go命令(如
go build、go run)。 - 配置步骤:
- 在 系统变量 列表中找到 Path 变量,点击 编辑
- 点击 新建,添加以下两个路径(分别对应Go命令和Go项目的可执行文件):
%GOROOT%\bin(Go命令所在目录)%GOPATH%\bin(项目编译后的可执行文件所在目录)
- 一路点击 确定 关闭所有弹窗

二、验证配置是否成功
- 打开 命令提示符(CMD) 或 PowerShell
- 输入以下命令检查环境变量:
go env GOROOT # 应输出:D:\goSDK\go1.23.1 go env GOPATH # 应输出:D:\code\GoLand go env GOCACHE # 应输出:E:\GOCACHE\go-build - 输入
go version,若显示版本信息(如go version go1.20 windows/amd64),则配置成功。
三、三个变量的通俗解释
| 变量 | 作用 | 类比(初学者理解) |
|---|---|---|
| GOROOT | Go语言的“老家”,存放官方提供的编译器、标准库(如fmt包)等核心文件。 |
相当于电脑上安装的“Office软件目录”。 |
| GOPATH | 你的“工作区”,存放自己写的代码和下载的第三方库(如GitHub上的开源包)。 | 相当于“我的文档”里专门放Go项目的文件夹。 |
| GOCACHE | 编译过程中的“缓存垃圾站”,存临时文件(如已编译的中间结果),可随时清理。 | 相当于浏览器缓存(如视频缓存文件)。 |
GoLand配置注意



推荐的go多版本切换,避免改GOROOT
https://github.com/voidint/g/releases/tag/v1.7.0
配置参考:Golang 多版本管理(g 工具)
ubuntu中的go安装配置
1. 下载并安装 Go 1.20
# 下载官方安装包(国内镜像,速度快)
wget https://golang.google.cn/dl/go1.20.linux-amd64.tar.gz
# 解压安装包(得到名为"go"的目录)
tar -zxvf go1.20.linux-amd64.tar.gz
# 移动到系统默认安装目录(需要管理员权限)
sudo mv go /usr/local/
2. 创建工作目录
# 创建 GOPATH 目录(自动创建中间目录,无需手动建"work")
mkdir -p /home/chenaws/work/go
3. 配置环境变量
# 编辑环境变量配置文件(新手推荐用 vim,按 i 进入编辑,Esc 后输入 :wq 保存退出)
vim ~/.bashrc
# 在文件末尾添加以下内容(直接复制粘贴):
# GOROOT:Go 本身的安装目录(固定值,和上面的移动路径对应)
export GOROOT=/usr/local/go
# GOPATH:工作目录(存放依赖缓存和编译产物,路径自定义)
export GOPATH=/home/chenaws/work/go
# PATH:让系统能找到 go 命令和编译后的程序
export PATH="$PATH:$GOROOT/bin:$GOPATH/bin"

4. 生效配置并验证
# 让环境变量立即生效(无需重启终端)
source ~/.bashrc
# 验证安装是否成功(输出 go1.20 版本即正确)
go version
二、关键配置补充(必做)
1. 开启 Go module(现代开发必需)
# 启用模块功能(Go 1.11+ 推荐,解决依赖管理问题)
go env -w GO111MODULE=on
2. 配置国内代理(解决下载依赖慢的问题)
# 设置国内代理,优先从国内源下载(避免访问国外服务器超时)
go env -w GOPROXY=https://goproxy.cn,https://proxy.golang.com.cn,direct
三、验证所有配置(确保正确)
执行以下命令,输出应与示例一致:
go env | grep -E "GOROOT|GOPATH|GO111MODULE|GOPROXY"

魔乐社区(Modelers.cn) 是一个中立、公益的人工智能社区,提供人工智能工具、模型、数据的托管、展示与应用协同服务,为人工智能开发及爱好者搭建开放的学习交流平台。社区通过理事会方式运作,由全产业链共同建设、共同运营、共同享有,推动国产AI生态繁荣发展。
更多推荐

所有评论(0)