GoLang文档教程

简体中文

English

简体中文

English

Appearance

Go 安装 for macOS ​

本文档介绍在 macOS 系统上安装 Go 语言环境的多种方法。

方法一：使用官方安装包（推荐） ​

1. 下载 Go 安装包 ​

访问 Go 语言 下载页面 下载 macOS 版本的安装包（.pkg 文件）。

或使用以下命令下载：

bash
# 下载 Go 1.21.5（示例版本，请根据实际需要修改）
curl -LO https://go.dev/dl/go1.21.5.darwin-amd64.pkg

注意：Apple Silicon (M1/M2/M3) 用户请下载 darwin-arm64 版本，Intel Mac 用户请下载 darwin-amd64 版本。

2. 运行安装程序 ​

双击下载的 .pkg 文件，按照安装向导提示完成安装。默认安装路径为 /usr/local/go。

3. 验证安装 ​

打开终端，输入以下命令：

bash
go version

你应该会看到类似如下的输出：

bash
go version go1.21.5 darwin/amd64

或（Apple Silicon）：

bash
go version go1.21.5 darwin/arm64

方法二：使用 Homebrew 安装 ​

如果您已安装 Homebrew，可以使用以下命令安装 Go：

bash
brew install go

安装完成后验证：

bash
go version

方法三：使用官方二进制包手动安装 ​

1. 下载并解压 ​

bash
# 下载（Apple Silicon）
curl -LO https://go.dev/dl/go1.21.5.darwin-arm64.tar.gz

# 或下载（Intel Mac）
curl -LO https://go.dev/dl/go1.21.5.darwin-amd64.tar.gz

# 解压到 /usr/local 目录
sudo tar -C /usr/local -xzf go1.21.5.darwin-arm64.tar.gz

2. 配置环境变量 ​

编辑 ~/.zshrc 或 ~/.bash_profile 文件：

bash
export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

使环境变量生效：

bash
source ~/.zshrc

配置 Go 模块代理（中国大陆用户） ​

如果您在中国大陆，建议配置 Go 模块代理以加速依赖下载：

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

或者使用七牛云代理：

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

设置 Go 工作空间 ​

创建 Go 工作空间目录结构：

bash
mkdir -p $HOME/go/{bin,pkg,src}

卸载 Go ​

使用安装包安装的卸载方法 ​

bash
sudo rm -rf /usr/local/go

使用 Homebrew 安装的卸载方法 ​

bash
brew uninstall go

并从 ~/.zshrc 或 ~/.bash_profile 中删除相关的环境变量配置。

下一步 ​

安装完成后，您可以：

完整示例 ​

安装完成后，用下面的程序在命令行验证工具链。复制到文件后执行 go run main.go。

go
package main

import (
	"fmt"
	"os/exec"
	"runtime"
	"strings"
)

func main() {
	out, err := exec.Command("go", "version").Output()
	fmt.Println("go command found in PATH:", err == nil)
	fmt.Println("version output starts with go:", err == nil && strings.HasPrefix(string(out), "go"))
	fmt.Println("GOROOT is set:", runtime.GOROOT() != "")
}

预期输出：

text
go command found in PATH: true
version output starts with go: true
GOROOT is set: true

常见错误与踩坑 ​

  • 选对安装包架构。 Apple Silicon（M 系列）选 arm64，Intel Mac 选 x86-64。
  • 不要混用官方 pkg 与 Homebrew。 用 which -a go 检查，并确认 PATH 顺序（/usr/local/go/bin 与 /opt/homebrew/bin）。
  • 修改 ~/.zshrc 后要重载。 执行 source ~/.zshrc 让新路径生效。
  • 使用 cgo 需要 Xcode Command Line Tools。 纯 Go 构建不需要，但依赖 cgo 的包必须安装。
  • 卸载官方安装包时，删除 /usr/local/go 并清理手动添加的 PATH。

更新记录 ​

  • 2026-10-14：新增"阅读提示"、完整可运行示例（含预期输出）、常见错误与踩坑清单，以及本更新记录；修复了页面底部指向不存在页面的相对链接。