首页 / Go 语言入门教程 / 安装 Go 开发环境

Go 语言入门教程

安装 Go 开发环境

本教程共 80 篇 · 第 2 篇 · 更新于 2026-07-27 · 约 7 分钟阅读

GoGo 入门教程Go 安装环境配置GOROOTGOPATHGo 1.26

2. 安装 Go 开发环境

本节目标:在电脑上装好 Go 1.26,配置好环境变量,跑通第一个 go version 命令。

下载 Go

打开浏览器,访问 Go 官方下载页面:

https://go.dev/dl/

页面上会列出各平台的安装包。选你对应系统的版本,下载最新稳定版(本教程写的时候是 go1.26.5)。

Tip

如果国内访问慢,可以用国内镜像:https://golang.google.cn/dl/

Windows 安装

步骤一:运行安装包

  1. 双击下载的 .msi 文件(比如 go1.26.5.windows-amd64.msi
  2. 按提示点击 Next,安装路径建议保持默认 C:\Program Files\Go
  3. 点击 Install,等待安装完成

安装程序会自动帮你配置好环境变量,不需要手动设置 GOROOTPATH

步骤二:验证安装

打开命令提示符(按 Win+R,输入 cmd,回车),输入:

go version

看到类似下面的输出就说明装好了:

go version go1.26.5 windows/amd64

macOS 安装

方式一:官方安装包

  1. 双击下载的 .pkg 文件
  2. 按提示安装,Go 会被装到 /usr/local/go
  3. 安装包会自动把 /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

安装完成检查清单

确认以下几项都没问题,就可以进入下一节了:

  1. go version 能输出版本号
  2. go env GOROOT 显示安装目录
  3. go env GOPATH 显示工作空间
  4. GOPATH/bin 已加入 PATH
  5. 国内用户已配置 GOPROXY
Tip

不需要手动创建 GOPATH 目录。第一次用 go installgo mod 时,Go 会自动帮你创建。

下一节,我们来写第一个 Go 程序。