在 macOS 上用 Homebrew 安装 Go 并配置 GOPATH、GOBIN 环境变量,再通过 go version、go env 和 go run hello.go 验证,最后搭配 VS Code 官方 Go 插件即可完成开发环境搭建。

在 macOS 上搭建 Go 开发环境其实很直接,关键是选对安装方式、配好环境变量,并验证是否生效。下面分几步说清楚,不绕弯子。
用 Homebrew 安装 Go(推荐)
Homebrew 是 macOS 最常用的包管理器,安装 Go 最省心的方式就是它。
- 如果还没装 Homebrew,先在终端运行:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 装好后执行:
brew install go - Homebrew 会自动把 Go 装到 /opt/homebrew/bin/go(Apple Silicon)或 /usr/local/bin/go(Intel),并确保命令行可识别
手动配置 GOPATH 和 GOBIN(可选但建议)
从 Go 1.16 起,模块模式默认开启,GOPATH 不再强制用于项目存放,但某些工具或老项目仍依赖它。建议明确设一个干净的路径。
- 在终端中运行:
mkdir -p ~/go/{bin,src,pkg} - 编辑 shell 配置文件(zsh 用户改 ~/.zshrc,bash 用户改 ~/.bash_profile):
echo 'export GOPATH=$HOME/go' >> ~/.zshrc
echo 'export GOBIN=$GOPATH/bin' >> ~/.zshrc
echo 'export PATH=$PATH:$GOBIN' >> ~/.zshrc - 重载配置:
source ~/.zshrc
验证安装是否成功
别跳过这步,三行命令就能确认环境跑得稳不稳。
立即学习“go语言免费学习笔记(深入)”;
- 查看 Go 版本:
go version(应输出类似 go version go1.22.3 darwin/arm64) - 检查环境变量:
go env GOPATH GOBIN GOROOT(确认路径合理,GOROOT 通常是 Homebrew 自动设好的) - 写个小程序试试:
echo 'package main; import "fmt"; func main() { fmt.Println("Hello, Go!") }' > hello.go
go run hello.go(终端应输出 Hello, Go!)
顺手配个代码编辑器(VS Code 示例)
写 Go 不一定非用 VS Code,但它插件成熟,对新手最友好。
- 安装 VS Code 后,扩展里搜 “Go”,装官方 Microsoft 提供的插件
- 首次打开 .go 文件时,它会提示安装依赖工具(如 gopls、dlv、goimports),点 “Install All” 就行
- 确保设置里启用了 “Format: Format On Save”,写代码更省心
基本上就这些。不用折腾 SDK 管理器,也不用下载压缩包解压配路径——Homebrew + 明确 GOPATH + 验证三步走,环境就立住了。










