macOS 上 Go 开发环境配置需完成安装、环境变量设置、模块代理配置及验证：一、用官方 .pkg 或 Homebrew 安装；二、配置 GOPATH、PATH（Homebrew 方式还需 GOROOT）；三、设置 GOPROXY 为 https://goproxy.cn,direct；四、通过 go version 和 Hello World 验证。
如果您在mac OS 系统上准备开始 Go 语言开发，但尚未安装或正确配置 Go 运行环境，则可能是由于 Go 二进制未就位、环境变量缺失或路径配置错误导致命令不可用。以下是针对 Mac 平台的多种安装与配置方法：
一、通过官方 .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、在终端中运行
which brew，若无输出，需先执行 Homebrew 官方安装脚本完成部署。
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，应显示指向 Cellar 目录的链接。
三、配置 GOPATH 与 PATH 环境变量
无论采用上述哪种安装方式，都必须显式设置 GOPATH（工作区路径）并将 Go 可执行目录加入 PATH，否则go get、go install等命令将无法定位模块或生成可执行文件。
1、在终端中执行
echo $SHELL判断当前 shell 类型：若输出为/bin/zsh（macOS Catalina 及以后默认），则编辑~/.zshrc；若为/bin/bash，则编辑~/.bash_profile。
2、执行
nano ~/.zshrc（或vi ~/.zshrc），在文件末尾添加以下两行：export GOPATH=$HOME/go通义灵码 Mac版通义灵码 Mac版是阿里云推出的一款AI智能编码助手，深度集成于Xcode、VS Code及JetBrains等主流IDE中。它基于大模型技术，支持行级/函数级实时续写、自然语言生成代码、单元测试生成及智能问答等核心功能。macOS用户可通过插件市场直接安装，开箱即用，旨在辅助开发者高效完成编码任务，提升研发效率。
下载export PATH=$PATH:/usr/local/go/bin:$GOPATH/bin 3、若使用 Homebrew 安装方式，还需补充 GOROOT 配置（替换为实际路径）：export GOROOT=/usr/local/Cellar/go/1.22.0/libexec
4、保存并退出编辑器，执行
source ~/.zshrc（或source ~/.bash_profile）使配置立即生效。
四、配置 Go 模块代理（goproxy）
由于网络限制，直接从官方模块仓库拉取依赖常失败；配置可信代理可确保go mod download、go get等操作稳定执行。
1、在终端中执行以下命令，全局启用国内代理：
go env -w GOPROXY=https://goproxy.cn,direct
2、验证代理是否生效：执行
go env GOPROXY，输出应为https://goproxy.cn,direct。
3、如需临时禁用代理，执行：
go env -u GOPROXY。
五、验证安装与运行 Hello World
该步骤用于确认 Go 编译器、模块系统及环境变量全部正常，是安装流程的最终功能性检验。
1、在终端中创建项目目录：
mkdir ~/helloworld && cd ~/helloworld。
2、创建源文件：
cat > main.go。
3、初始化模块：
go mod init helloworld。
4、运行程序：
go run main.go，终端应立即输出Hello, World!。