macOS上基于Homebrew的Go语言环境与Go Tour安装配置指南-Golang-PHP中文网

macOS上基于Homebrew的Go语言环境与Go Tour安装配置指南

聖光之護

发布： 2025-09-19 14:06:01

原创

812人浏览过

macOS上基于Homebrew的Go语言环境与Go Tour安装配置指南

本教程详细指导macOS用户如何使用Homebrew安装Go语言环境，并正确配置GOPATH、GOROOT及PATH环境变量。文章涵盖Go语言的安装、标准工作目录的创建，以及Go Tour的获取与运行，旨在帮助Go语言新手建立一个稳定且符合最佳实践的开发环境。

第一步：准备Go语言工作区与环境变量

在开始安装go语言之前，首先需要为go项目设置一个标准的工作区，并配置必要的环境变量。go语言的开发环境依赖于几个关键的环境变量：

GOPATH: Go语言的工作区路径，用于存放用户编写的Go代码、第三方库以及通过go get命令安装的工具的源代码和编译后的二进制文件。通常建议将其设置为用户主目录下的一个目录，例如$HOME/go。
GOROOT: Go语言的安装路径。当使用Homebrew安装Go时，这个路径会指向Homebrew管理下的Go安装目录。
PATH: 系统查找可执行文件的路径。为了能够直接在终端中运行go命令以及GOPATH/bin目录下安装的Go工具，需要将$GOROOT/bin和$GOPATH/bin添加到PATH中。

操作步骤：

创建Go工作区目录： 在您的用户主目录下创建go目录，并为其创建标准的子目录bin、src和pkg。
```
mkdir -p $HOME/go/{bin,src,pkg}
```
登录后复制

配置环境变量： 将GOPATH、GOROOT和PATH变量添加到您的shell配置文件中（例如~/.zshrc或~/.bash_profile），以确保每次打开终端时这些变量都能自动加载。

# 设置GOPATH为您的Go工作区路径
export GOPATH=$HOME/go

# 设置GOROOT为Homebrew安装的Go语言路径
# $(brew --prefix go) 会返回Homebrew安装Go的根目录，通常是 /usr/local/opt/go
export GOROOT="$(brew --prefix go)/libexec"

# 将Go的可执行文件路径添加到PATH中
# $GOROOT/bin 包含Go语言本身的核心命令（如go, gofmt等）
# $GOPATH/bin 包含通过go install或go get安装的用户工具
export PATH=$PATH:$GOPATH/bin:$GOROOT/bin

登录后复制

将上述三行export命令添加到您的shell配置文件（如~/.zshrc或~/.bash_profile）的末尾。例如，对于Zsh用户：

echo 'export GOPATH=$HOME/go' >> ~/.zshrc
echo 'export GOROOT="$(brew --prefix go)/libexec"' >> ~/.zshrc
echo 'export PATH=$PATH:$GOPATH/bin:$GOROOT/bin' >> ~/.zshrc

登录后复制

保存文件后，运行以下命令使配置立即生效：

source ~/.zshrc # 如果您使用的是Bash，则运行 source ~/.bash_profile

登录后复制

第二步：使用Homebrew安装Go语言

Homebrew是macOS上流行的包管理器，可以方便地安装和管理Go语言。

立即学习“go语言免费学习笔记（深入）”；

操作步骤：

安装Go： 在终端中执行以下命令安装Go语言。如果您的系统尚未安装Homebrew，请先访问Homebrew官网进行安装。
```
brew install go
```
登录后复制
验证Go安装： 安装完成后，通过go version命令检查Go语言是否成功安装及其版本信息。
```
go version
```
登录后复制
如果显示类似go version go1.x.x darwin/amd64的输出，则表示Go语言已成功安装。

Melodio
Melodio是全球首款个性化AI流媒体音乐平台，能够根据用户场景或心情生成定制化音乐。

110

查看详情

第三步：安装并运行Go Tour

Go Tour是一个交互式的Go语言教程，非常适合Go语言新手入门。它允许您在浏览器中边学习边实践Go代码。

操作步骤：

获取Go Tour： 使用go get命令下载并安装Go Tour工具。go get会自动从版本控制系统（如Git）获取源代码，并将其编译安装到$GOPATH/bin目录下。
```
go get golang.org/x/tour/gotour
```
登录后复制
注意： 较旧的Go Tour路径code.google.com/p/go-tour/gotour已废弃，请务必使用golang.org/x/tour/gotour。
运行Go Tour： 由于gotour工具已安装到$GOPATH/bin目录，且该目录已添加到您的PATH环境变量中，您现在可以直接在终端中运行gotour命令来启动它。
```
gotour
```
登录后复制
执行此命令后，Go Tour将在您的默认浏览器中打开，您可以开始学习Go语言。

注意事项与最佳实践

环境变量持久化： 务必将环境变量配置写入shell配置文件（如~/.zshrc或~/.bash_profile），否则每次打开新终端都需要重新设置。
GOPATH与Go Modules： 从Go 1.11版本开始引入的Go Modules是Go项目依赖管理的新标准。在启用Go Modules的项目中，GOPATH对于项目依赖的查找变得不那么重要，但对于全局工具（如gotour、gofmt等）的安装和存放，GOPATH/bin仍然发挥着关键作用。对于非模块化的老项目或全局工具，GOPATH仍然是必需的。
更新Go版本： 使用Homebrew更新Go语言非常简单，只需运行：
```
brew upgrade go
```
登录后复制
常见问题排查： 如果遇到command not found错误（例如运行gotour时），通常是PATH环境变量配置不正确或未生效。请仔细检查您的shell配置文件，并确保在修改后执行source命令使其生效。您可以使用echo $PATH和echo $GOPATH来检查当前的环境变量值。