📅 发布时间：2026/6/20 10:58:34

# adward @ adwarddeMacBook-Pro in ~  [10:41]  
$ go env GOPATH
/Users/adward/developer/machines/golang/gopath1.25.4
(base) 
# adward @ adwarddeMacBook-Pro in ~  [10:41]  
$ go env GOMODCACHE
/Users/adward/developer/machines/golang/gopath1.25.4/pkg/mod
(base) 
# adward @ adwarddeMacBook-Pro in ~  [10:41]  
$ go env GO_HOME   (base) 
# adward @ adwarddeMacBook-Pro in ~  [10:41]  
$ go env GOROOT 
/Users/adward/developer/machines/golang/go1.25.4
(base) 
# adward @ adwarddeMacBook-Pro in ~  [10:41]  
$

Go 环境变量入门笔记：GOROOT、GOPATH、GOPROXY 到底是干什么的？

之前学习 Go 的时候配置过一些环境变量，比如：

export GO_HOME="/Users/adward/developer/machines/golang/go1.25.4"
export GOPATH="/Users/adward/developer/machines/golang/gopath1.25.4"
export GOPROXY="https://goproxy.cn"

时间久了容易忘，这里简单整理一下。

1. GOROOT / GO_HOME：Go 本体在哪里

严格来说，Go 官方常用的是：

GOROOT

它表示：

Go 语言本体的安装目录

里面一般有：

bin/go
pkg/
src/

也就是说，GOROOT 里面放的是 Go 编译器、标准库、Go 自带工具等内容。

有些人习惯自己写一个：

export GO_HOME="/Users/adward/developer/machines/golang/go1.25.4"

这个 GO_HOME 不是 Go 官方核心变量，只是自己定义的一个别名。

通常会配合：

export PATH="$GO_HOME/bin:$PATH"

让终端能找到 go 命令。

简单理解：

GOROOT / GO_HOME = Go 本体安装在哪里

2. GOPATH：Go 的用户工作区

GOPATH 不是 Go 的安装目录。

它更像是 Go 给用户侧内容准备的工作区。

常见结构：

$GOPATH/bin
$GOPATH/pkg
$GOPATH/pkg/mod

现在最常见的用途有两个。

第一：保存 go install 安装出来的命令行工具

比如执行：

go install github.com/air-verse/air@latest

安装出来的 air 命令通常会放到：

$GOPATH/bin

所以通常需要配置：

export PATH="$GOPATH/bin:$PATH"

这样才能直接在终端执行：

air

第二：保存 Go 下载的第三方依赖缓存

现在 Go 项目主要使用 Go Modules，也就是项目里会有：

go.mod
go.sum

当项目需要第三方依赖时，Go 会把依赖源码下载到 module 缓存里，通常是：

$GOPATH/pkg/mod

例如：

$GOPATH/pkg/mod/github.com/gin-gonic/gin@v1.10.0

所以，项目越多，下载过的依赖越多，$GOPATH/pkg/mod 可能会越来越大。

这是正常的，因为 Go 是让多个项目共享同一个依赖缓存，避免每个项目都重复下载一份。

3. 现在还需要把项目放到 GOPATH/src 下面吗？

一般不需要。

早期 Go 项目通常要放在：

$GOPATH/src/xxx

但现在 Go Modules 已经是主流。

现在写项目通常是：

mkdir my-go-project
cd my-go-project
go mod init my-go-project

只要项目里有 go.mod，项目就可以放在任意目录，比如：

~/projects/my-go-app
~/Desktop/test-go
~/developer/workspace/demo

所以：

GOPATH 不是每个项目都设置一次

一般一台电脑设置一个 GOPATH 就够了。

4. go.mod 和 go.sum 是什么？

go.mod 可以理解成项目的依赖清单。

例如：

module my-appgo 1.25require github.com/gin-gonic/gin v1.10.0

它表示：

当前项目叫 my-app
使用 Go 1.25
依赖 github.com/gin-gonic/gin v1.10.0

go.sum 则主要记录依赖的校验信息，用来确认下载下来的依赖没有被篡改。

可以简单理解为：

go.mod = 依赖清单
go.sum = 依赖校验表

类比其他语言：

Go      -> go.mod / go.sum
Node.js -> package.json / package-lock.json
Python  -> requirements.txt / pyproject.toml / poetry.lock
Java    -> pom.xml / build.gradle

5. go get 和 go mod tidy 做了什么？

当执行：

go get github.com/gin-gonic/gin

或者：

go mod tidy

Go 大概会做这些事：

1. 分析当前项目需要哪些依赖
2. 修改 go.mod
3. 修改 go.sum
4. 下载依赖源码到 $GOPATH/pkg/mod
5. 后续编译时从缓存中读取这些源码

注意：

依赖源码通常不会复制到当前项目目录里

当前项目主要只是记录依赖信息。

真实源码通常在：

$GOPATH/pkg/mod

6. go install 和 go get 的区别

这个很容易混。

go get / go mod tidy

主要用于当前项目的依赖管理。

比如项目代码里用了：

import "github.com/gin-gonic/gin"

这时候通常使用：

go get github.com/gin-gonic/gin

或者：

go mod tidy

它们会更新当前项目的 go.mod 和 go.sum。

go install

主要用于安装命令行工具。

比如：

go install github.com/air-verse/air@latest

它会把可执行文件安装到：

$GOPATH/bin

如果设置了 GOBIN，则会安装到 GOBIN 指定的位置。

简单记：

项目要 import 的库：go get / go mod tidy
终端要直接运行的工具：go install

7. GOPROXY：Go 下载依赖的代理

GOPROXY 表示 Go 下载第三方依赖时走哪个代理。

比如：

export GOPROXY=" https://goproxy.cn ,direct"

含义是：

优先从 goproxy.cn 下载依赖
如果代理下载不到，就 direct 直接访问原始地址

在国内环境下，配置 GOPROXY 可以明显减少依赖下载失败的问题。

8. 推荐的基础配置

如果是自己手动管理 Go 安装目录，可以这样配置：

export GO_HOME="/Users/adward/developer/machines/golang/go1.25.4"
export GOROOT="$GO_HOME"export GOPATH="/Users/adward/developer/machines/golang/gopath1.25.4"
export GOPROXY=" https://goproxy.cn ,direct"export PATH="$GOROOT/bin:$GOPATH/bin:$PATH"

含义分别是：

GO_HOME / GOROOT：Go 本体安装目录
GOPATH：Go 用户工作区
GOPROXY：Go 下载依赖使用的代理
PATH：让系统能找到 go 命令和 go install 安装的工具

9. 如果 GOPATH 太大怎么办？

因为依赖缓存都在：

$GOPATH/pkg/mod

所以用久了可能会变大。

可以查看当前配置：

go env GOPATH
go env GOMODCACHE

清理 module 缓存：

go clean -modcache

清理后，如果项目再次需要这些依赖，Go 会重新下载。

最后总结

可以用这一句话记住：

GOROOT / GO_HOME：Go 本体在哪里
GOPATH：Go 的用户工作区，放工具和依赖缓存
GOPROXY：Go 下载依赖走哪个代理
go.mod：当前项目需要哪些依赖
go.sum：依赖校验信息

再压缩一点：

go.mod 负责记录“这个项目要什么”
$GOPATH/pkg/mod 负责保存“真实下载下来的依赖”
$GOPATH/bin 负责保存“go install 安装出来的工具”

现在写 Go 项目，重点看项目里有没有 go.mod，而不是看它是不是放在 $GOPATH/src 下面。

[go v01 ]