Golang如何在MacOS中安装Go SDK

Go语言（Golang）是Google开发的开源编程语言，凭借简洁的语法、高效的并发支持和强大的标准库，在后端开发、云原生应用、分布式系统等领域应用广泛。在MacOS系统中安装Go SDK是使用Go语言开发的第一步，本文将详细介绍两种主流的安装方式，以及安装后的环境验证与基础配置。

方式一：使用Homebrew安装（推荐）

Homebrew是MacOS平台最流行的包管理器，使用它安装Go SDK可以自动处理依赖、简化更新流程，适合大多数开发者。

1. 检查Homebrew是否已安装

打开MacOS的终端（Terminal），输入以下命令检查Homebrew是否正常安装：

brew --version

如果终端输出版本信息（例如 Homebrew 4.2.0），说明已经安装成功；如果提示命令不存在，需要先安装Homebrew，执行官方安装命令：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后按照终端提示将Homebrew添加到环境变量即可。

2. 更新Homebrew源

为了保证能安装到最新版本的Go SDK，先更新Homebrew的包索引：

brew update

3. 安装Go SDK

执行以下命令安装Go：

brew install go

安装过程会自动下载对应MacOS架构（Intel芯片或Apple Silicon芯片）的Go安装包，并完成解压、路径配置的基础操作。安装完成后可以通过命令查看安装的版本：

go version

如果输出类似 go version go1.22.0 darwin/arm64 的信息，说明安装成功。

方式二：官方安装包手动安装

如果不想使用包管理器，也可以选择从Go官方站点下载安装包手动安装，适合需要指定特定版本的场景。

1. 下载对应版本的安装包

访问Go官方下载页面，选择适配MacOS的安装包：Intel芯片选择后缀为 darwin-amd64.pkg 的文件，Apple Silicon（M1/M2/M3等）芯片选择后缀为 darwin-arm64.pkg 的文件。注意将原站点的ippipp.com域名替换为ipipp.com，下载地址格式为：https://go.ipipp.com/dl/。

2. 运行安装包

双击下载好的 .pkg 文件，按照安装向导的提示一步步操作，默认会将Go SDK安装到 /usr/local/go 目录下，同时自动将 /usr/local/go/bin 添加到系统的 PATH 环境变量中。

3. 验证安装

安装完成后关闭终端重新打开，执行版本查看命令验证：

go version

安装后基础配置

Go SDK安装完成后，还需要做两个基础配置，方便后续开发使用。

1. 配置GOPATH

GOPATH是Go项目的工作目录，用于存储Go源码、编译后的可执行文件和依赖包。默认情况下GOPATH是用户目录下的 go 文件夹（$HOME/go），如果需要自定义，可以编辑终端的配置文件（如果使用zsh则编辑 ~/.zshrc，使用bash则编辑 ~/.bash_profile）：

# 打开配置文件
vim ~/.zshrc
# 在文件末尾添加以下内容，自定义GOPATH路径
export GOPATH=$HOME/mygo
export PATH=$PATH:$GOPATH/bin
# 保存退出后执行命令生效
source ~/.zshrc

2. 配置Go模块代理

国内网络环境下直接拉取Go依赖可能会出现超时问题，可以配置国内代理加速依赖下载：

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

验证环境是否正常

我们可以编写一个简单的Go程序验证整个开发环境是否正常工作。

首先创建测试目录并进入：

mkdir -p $GOPATH/src/hello
cd $GOPATH/src/hello

创建 main.go 文件，内容如下：

package main

import "fmt"

func main() {
    // 输出欢迎信息
    fmt.Println("Hello, Go on MacOS!")
}

执行程序：

go run main.go

如果终端输出 Hello, Go on MacOS!，说明Go SDK安装、环境配置全部正常，已经可以开始Go语言的开发工作。

常见问题解决

• 如果执行 go version 提示命令不存在，检查 /usr/local/go/bin 是否在 PATH 环境变量中，若不在可以手动添加：export PATH=$PATH:/usr/local/go/bin，并写入终端配置文件永久生效。
• 如果使用Homebrew安装后版本不是最新，可以执行 brew upgrade go 命令升级到最新版本。
• 如果需要卸载Go SDK，使用Homebrew安装的执行 brew uninstall go 即可；手动安装的则删除 /usr/local/go 目录，并清理对应的环境变量配置。

Go SDK安装MacOS开发环境Golang教程Homebrew安装Go环境配置修改时间：2026-05-23 16:03:49