macOS上搭建Go开发环境需安装Go工具链、配置GOPATH与PATH、设置国内代理并验证项目。推荐官方.pkg或Homebrew安装，编辑~/.zshrc配置环境变量，执行go env -w设置GOPROXY=https://goproxy.cn,direct，最后用go mod init和go run验证。
如果您在 macOS 系统上需要搭建 Go 语言开发环境，但尚未安装 Go 工具链或环境变量配置不完整，则可能导致 go 命令无法识别、go mod 下载失败 或 VSCode 中无代码补全与调试支持。以下是适用于 macOS 的多种安装与配置方法：
一、通过官方 .pkg 安装包安装 Go
该方法直接使用 Go 官方发布的图形化安装包，无需额外依赖，适合网络稳定且偏好可视化操作的用户。安装后 Go 二进制文件默认置于 /usr/local/go，系统自动注册基础路径。
1、访问 Go 官方下载页 https://golang.google.cn/dl/ 或国内镜像站（如清华大学镜像 https://mirrors.tuna.tsinghua.edu.cn/golang/）。
2、根据 Mac 架构选择对应安装包：Intel 芯片选 darwin-amd64.pkg，Apple Silicon（M1/M2/M3）芯片选 darwin-arm64.pkg。
立即学习“go语言免费学习笔记（深入）”；
3、双击下载的 .pkg 文件，按向导提示完成安装（全部点击“继续”即可）。
4、打开终端，执行 go version 验证是否输出类似 go version go1.22.0 darwin/arm64 的信息。
二、通过 Homebrew 安装 Go
该方法适合已配置 Homebrew 的开发者，可统一管理命令行工具，便于版本切换与批量更新。Homebrew 安装的 Go 默认位于 /usr/local/Cellar/go/x.x.x/libexec，需手动配置 GOROOT。
1、确保已安装 Homebrew：在终端中运行 which brew，若无输出则先执行官网安装脚本。
2、执行安装命令：brew install go。
3、安装完成后，查看实际路径：brew --prefix go，输出类似 /usr/local/Cellar/go/1.22.0。
4、确认 /usr/local/bin/go 是 Homebrew 创建的软链接，且可执行：ls -l /usr/local/bin/go。
三、配置 GOPATH 与 PATH 环境变量
无论采用哪种安装方式，都必须显式设置 GOPATH（工作区路径）和将 Go 可执行目录加入 PATH，否则 go get、go install 等命令将无法定位模块或生成可执行文件。
1、打开终端，判断当前 shell 类型：echo $SHELL；若为 /bin/zsh（macOS Catalina 及以后默认），编辑 ~/.zshrc；若为 /bin/bash，编辑 ~/.bash_profile。
2、执行 vi ~/.zshrc（或 nano ~/.zshrc），在文件末尾添加以下两行：
export GOPATH=$HOME/go
export PATH=$PATH:/usr/local/go/bin:$GOPATH/bin
3、保存并退出编辑器，执行 source ~/.zshrc（或 source ~/.bash_profile）使配置立即生效。
4、验证配置：go env GOPATH 应返回 /Users/用户名/go；echo $PATH 应包含 /usr/local/go/bin 和 /Users/用户名/go/bin。
四、配置国内模块代理（GOPROXY）
由于官方模块代理 proxy.golang.org 在中国大陆常不可达，未配置代理会导致 go mod tidy 卡死或报错 timeout。此步骤直接影响依赖下载成功率，属于国内开发必备配置。
1、在终端中执行以下命令（写入当前 shell 配置）：
go env -w GOPROXY=https://goproxy.cn,direct
2、同时建议配置校验数据库源以避免 checksum mismatch 错误：
go env -w GOSUMDB=sum.golang.google.cn
3、验证配置是否生效：go env GOPROXY 输出应为 https://goproxy.cn,direct；go env GOSUMDB 输出应为 sum.golang.google.cn。
五、验证与初始化首个 Go 项目
完成前述步骤后，需通过真实项目验证整个工具链是否协同工作，包括编译、模块初始化、依赖拉取与执行，这是确认环境可用性的最终操作环节。
1、创建项目目录：mkdir -p ~/go/src/hello && cd ~/go/src/hello。
2、初始化模块：go mod init hello，生成 go.mod 文件。
3、新建 main.go，内容为：
package main
import "fmt"
func main() { fmt.Println("Hello, Go on macOS!") }
4、执行编译与运行：go run main.go，终端应立即输出 Hello, Go on macOS!。
