go语言教程:安装、配置环境变量

下载地址

https://go.dev/dl/

测试命令

执行下面命令:

go version

显示如下:

go version go1.25.13 windows/amd64

说明安装成功

查看环境变量

查看全部环境变量

go env

查看某个环境变量

go env GOPROXY

配置环境变量

GOPATH

传统 GOPATH 模式,新项目基本不用

现代 Go 项目全部使用 Go Module(go mod init),不再强制依赖 GOPATH。
GOPATH 现在只影响:go install 编译出来的二进制默认放 $GOPATH/bin,以及 GOMODCACHE 默认继承它。

是否执行修改都可以:

go env -w GOPATH=D:\devtools\gopath

GOMODCACHE(重要)

Go Module 的依赖包缓存目录,等价于 Maven repository、npm cache。

  • 默认值:$GOPATH/pkg/mod
  • 作用:所有下载的第三方源码包都会缓存在这里,多个项目复用;不会像 node 每个项目单独一份 node_modules

推荐放到独立磁盘,如:

  • Windows:D:\go-mod-cache
  • Linux:/data/gomodcache

修改

go env -w GOMODCACHE=D:\devtools\go-mod-cache
好处
  1. 多开发机 / CI 构建机可以做共享只读缓存盘,加速 CI 编译
  2. 避免 GOPATH 所在磁盘占满
  3. 容器构建时,挂载该目录做缓存,减少外网拉包

GOCACHE(编译产物缓存)

存放编译中间产物,加速重复编译。

  • 默认:操作系统用户缓存目录(~/.cache/go-build Linux)
  • 企业 CI 场景:同样建议单独挂载缓存目录,否则每次 CI 都全量重编译,耗时巨大。

推荐修改:

go env -w GOCACHE=D:\devtools\go-build

GOPROXY(必配)

作用:用来下载 go module 依赖包,直接访问国外 github 源很慢,经常超时。

相当于maven代理

国内最常用:

go env -w GOPROXY=https://goproxy.cn,direct

go语言环境变量配置文件

Windows
%APPDATA%\go\env

查看内容:

GOCACHE=D:\devtools\go-build
GOMODCACHE=D:\devtools\go-mod-cache
GOPATH=D:\devtools\gopath
GOPROXY=https://goproxy.cn,direct
Linux/MacOS
~/.config/go/env

添加到系统环境变量

执行 go install 命令编译包,二进制直接输出到%GOPATH%\bin 目录

可以指定 GOBIN 目录,一般不推荐配置

需要将 %GOPATH%\bin 目录添加到系统环境变量 path 中,否则执行 编译包会提示找不到命令:

D:\devtools\gopath\bin

测试

执行下面命令:

go install github.com/google/pprof@latest

下载、编译 pprof包,二进制文件输出到 D:\devtools\gopath\bin 目录

测试 pprof 命令:

pprof

不报错说明配置成功