【go】初学者入门环境配置，GOPATH，GOROOT，GOCACHE，以及GoLand使用配置注意

一、环境变量配置步骤

1. 打开环境变量设置

• Win + R 后输入 sysdm.cpl → 点击 确定
• 在弹出窗口中点击 高级 → 环境变量

2. 配置 GOROOT（Go语言安装根目录）

• 作用：告诉系统Go语言的安装位置（编译器、标准库等核心文件所在路径）。
• 配置步骤：
  1. 在 系统变量 区域点击 新建
  2. 变量名：GOROOT
  3. 变量值：D:\goSDK\go1.23.1（你的Go安装目录，这里添加一个上级目录，方便多版本管理）
  4. 点击 确定

3. 配置 GOPATH（工作目录）

• 作用：存放你的Go项目代码src、依赖包pkg和编译结果bin。
• 配置步骤：
  1. 在 系统变量 区域点击 新建
  2. 变量名：GOPATH
  3. 变量值：D:\code\GoLand（你的工作目录，建议设为项目存放位置）
  4. 点击 确定

这里主要是bin目录和pkg目录的存放位置，不能动，必须在GOPATH下；通常，我们的项目代码src可以放在这里，自己在GOPATH下建一个src，里面就是项目目录，当然，src也可以不放在GOPATH下，任意位置都可以

• 目录结构：在 GOPATH（即 D:\code\GoLand）下创建一个子目录src，另外俩会自己生成：

  D:\code\GoLand\
  ├── src\       # 存放源代码（如项目文件夹）
  ├── pkg\       # 存放编译后的包文件（自动生成）
  └── bin\       # 存放编译后的可执行文件（自动生成）
  

4. 配置 GOCACHE（编译缓存目录）

• 作用：存放编译过程中的临时文件，加速后续编译（类似浏览器缓存）。
• 配置步骤：
  1. 在 系统变量 区域点击 新建
  2. 变量名：GOCACHE
  3. 变量值：E:\GOCACHE\go-build（非系统盘的目录，节省C盘空间）
  4. 点击 确定

GOCACHE可以不配置，默认会存在C:\Users\用户名\AppData\Local\go-build这里，我的c盘紧缺，用到后面会占很多地方，所以配置到E盘

5. 更新 PATH 变量（重要！）

• 作用：让系统能够找到Go命令（如go build、go run）。
• 配置步骤：
  1. 在 系统变量 列表中找到 Path 变量，点击 编辑
  2. 点击 新建，添加以下两个路径（分别对应Go命令和Go项目的可执行文件）：
     • %GOROOT%\bin（Go命令所在目录）
     • %GOPATH%\bin（项目编译后的可执行文件所在目录）
  3. 一路点击 确定 关闭所有弹窗
     

二、验证配置是否成功

1. 打开 命令提示符（CMD） 或 PowerShell
2. 输入以下命令检查环境变量：

   go env GOROOT     # 应输出：D:\goSDK\go1.23.1
   go env GOPATH     # 应输出：D:\code\GoLand
   go env GOCACHE    # 应输出：E:\GOCACHE\go-build
   

3. 输入 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 工具）

---

https://github.com/0voice