安装 Go 开发环境
本教程共 80 篇 · 第 2 篇 · 更新于 2026-07-27 · 约 7 分钟阅读
2. 安装 Go 开发环境
本节目标:在电脑上装好 Go 1.26,配置好环境变量,跑通第一个
go version命令。
下载 Go
打开浏览器,访问 Go 官方下载页面:
https://go.dev/dl/
页面上会列出各平台的安装包。选你对应系统的版本,下载最新稳定版(本教程写的时候是 go1.26.5)。
Tip如果国内访问慢,可以用国内镜像:
https://golang.google.cn/dl/
Windows 安装
步骤一:运行安装包
- 双击下载的
.msi文件(比如go1.26.5.windows-amd64.msi) - 按提示点击 Next,安装路径建议保持默认
C:\Program Files\Go - 点击 Install,等待安装完成
安装程序会自动帮你配置好环境变量,不需要手动设置 GOROOT 和 PATH。
步骤二:验证安装
打开命令提示符(按 Win+R,输入 cmd,回车),输入:
go version
看到类似下面的输出就说明装好了:
go version go1.26.5 windows/amd64
macOS 安装
方式一:官方安装包
- 双击下载的
.pkg文件 - 按提示安装,Go 会被装到
/usr/local/go - 安装包会自动把
/usr/local/go/bin加到PATH
方式二:Homebrew
如果你用了 Homebrew,一行命令搞定:
brew install go
验证
打开终端,输入:
go version
输出类似 go version go1.26.5 darwin/amd64 就 OK。
Linux 安装
Linux 没有图形化安装包,需要手动解压。
步骤一:删除旧版本(如果有)
sudo rm -rf /usr/local/go
步骤二:解压安装包
sudo tar -C /usr/local -xzf go1.26.5.linux-amd64.tar.gz
步骤三:配置 PATH
编辑你的 ~/.profile 或 ~/.bashrc(如果用 zsh 就编辑 ~/.zshrc),添加一行:
export PATH=$PATH:/usr/local/go/bin
保存后执行:
source ~/.profile
步骤四:验证
go version
输出 go version go1.26.5 linux/amd64 就成功了。
理解环境变量
安装完 Go 之后,有几个环境变量你需要知道。
GOROOT
GOROOT 是 Go 的安装目录。Windows 上默认是 C:\Program Files\Go,Linux/macOS 上是 /usr/local/go。
现在你基本不需要手动设置 GOROOT,安装程序已经帮你处理好了。go 命令自己知道它在哪。
GOPATH
GOPATH 是 Go 的工作空间目录。在早期的 GOPATH 模式下,你的代码和下载的依赖都放在这里。
现在 Go 默认使用模块模式(Module mode),GOPATH 主要用来:
- 存放
go install安装的工具二进制文件(在$GOPATH/bin) - 存放下载的模块缓存(在
$GOPATH/pkg/mod)
默认值:
- Windows:
%USERPROFILE%\go(比如C:\Users\你的用户名\go) - Linux/macOS:
$HOME/go
你可以用这个命令查看当前的 GOPATH:
go env GOPATH
Note如果你用了 Go 1.26,大部分情况下不需要改 GOPATH。默认值就挺好用的。如果你想自定义,可以用
go env -w GOPATH=/your/path。
GOPATH/bin 加入 PATH
有个小细节要注意:go install 装的工具会放在 $GOPATH/bin 目录下。你想在任何地方都能用这些工具,就得把这个目录加到 PATH 里。
Windows:在系统环境变量里添加 %USERPROFILE%\go\bin
macOS/Linux:在 ~/.profile 里加:
export PATH="$PATH:$(go env GOPATH)/bin"
配置国内代理
如果你在国内,下载依赖可能会超时。建议配置代理:
go env -w GOPROXY=https://goproxy.cn,direct
这个设置会让 Go 从国内镜像下载模块,速度会快很多。
go env 命令
go env 是查看和设置 Go 环境变量的命令。
查看所有环境变量:
go env
查看某个特定变量:
go env GOPATH
go env GOROOT
go env GOPROXY
设置变量(-w 表示写入配置文件,永久生效):
go env -w GOPROXY=https://goproxy.cn,direct
取消设置(-u):
go env -u GOPROXY
常见问题
命令行找不到 go 命令
你在命令行输入 go version 提示「不是内部或外部命令」,多半是 PATH 没配好。
Windows 用户检查一下:右键「此电脑」→ 属性 → 高级系统设置 → 环境变量 → 系统变量里的 PATH,看有没有 C:\Program Files\Go\bin。
macOS/Linux 用户检查你的 shell 配置文件有没有加 export 那行。
装了多个版本冲突
如果你之前装过旧版 Go,建议先卸载干净再装新的。Windows 直接在「设置 → 应用」里卸载,Linux 删掉 /usr/local/go 目录,macOS 删掉 /usr/local/go 目录。
PowerShell 执行策略问题
Windows 上用 PowerShell 跑 Go 工具时偶尔会遇到执行策略限制。以管理员身份运行 PowerShell,执行:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
安装完成检查清单
确认以下几项都没问题,就可以进入下一节了:
go version能输出版本号go env GOROOT显示安装目录go env GOPATH显示工作空间GOPATH/bin已加入 PATH- 国内用户已配置 GOPROXY
Tip不需要手动创建 GOPATH 目录。第一次用
go install或go mod时,Go 会自动帮你创建。
下一节,我们来写第一个 Go 程序。