Mac 安装 Go 环境推荐官方 .pkg（自动配 PATH/GOROOT）或 Homebrew（适合多版本管理），需手动配置 ~/.zshrc 中 GOROOT、GOPATH 和 PATH，设置 GOPROXY=https://goproxy.cn,direct，并安装 dlv 与 gopls 以支持 VSCode 调试。
Mac 上安装 Golang 开发环境，只要选对方式、配对路径、设好代理，5 分钟内就能跑起 go run main.go —— 但 90% 的失败都卡在环境变量没生效，或 GOPROXY 没配，导致 go mod tidy 卡死不动。
用 .pkg 安装包还是 Homebrew？看你的使用场景
官方 .pkg 安装包（推荐给刚接触 Go 或需要稳定版本的用户）会自动把 /usr/local/go/bin 加进系统 PATH，并默认设好 GOROOT；Homebrew 安装（brew install go）更灵活，适合经常切换版本或用 brew bundle 管理工具链的开发者。但注意：
• Homebrew 安装的 Go 默认不写入 shell 配置文件，go version 可能报 command not found
• Apple Silicon（M1/M2/M3）芯片务必下载 darwin-arm64.pkg，别错选 amd64 版本，否则运行时报 bad CPU type in executable
• 覆盖安装新版 .pkg 不会影响已有 GOPATH 和模块缓存，但建议装完后执行 source ~/.zshrc 确保 PATH 刷新
PATH 和 GOPATH 必须手动检查的三个位置
Mac 默认 shell 是 zsh，所以环境变量必须写进 ~/.zshrc（不是 ~/.bash_profile，除非你主动改过 shell）。常见错误是只加了 /usr/local/go/bin，漏掉 $GOPATH/bin，导致 go install 安装的工具（如 dlv）找不到命令。
• 打开终端，运行 echo $SHELL 确认当前 shell
• 编辑 ~/.zshrc，添加以下两行（GOPATH 可自定义，但别用空格或中文路径）：
export GOROOT=/usr/local/go export GOPATH=$HOME/go export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
• 执行
source ~/.zshrc 后，验证：go env GOROOT 应输出 /usr/local/go，go env GOPATH 应输出你设的路径• 如果仍提示
command not found: go，检查 which go 是否为空；若为空，说明 PATH 没生效，重启终端或运行 exec zsh
国内网络下 go mod 卡住？立刻配 GOPROXY
不配代理时，go get 或 go mod download 会直连 proxy.golang.org，大概率超时或返回 403。这不是网络问题，而是 Go 模块生态默认依赖境外基础设施。
• 推荐配置（任选其一，goproxy.cn 稳定性略优于七牛云）：
go env -w GOPROXY=https://goproxy.cn,direct go env -w GOSUMDB=sum.golang.google.cn
• 验证是否生效：
go env GOPROXY 输出应为 https://goproxy.cn,direct• 若项目含私有 Git 仓库（如公司内部 GitLab），需额外设置：
go env -w GOPRIVATE=git.example.com/mygroup/*，否则代理会尝试转发私有地址导致失败• 注意：设置后所有新终端窗口自动继承，但已打开的终端需重新运行
source ~/.zshrc 或新开窗口
VSCode 调试跑不起来？重点查 gopls 和 dlv
VSCode 的 Go 扩展（golang.Go）首次打开 .go 文件时会弹窗提示安装工具链，其中 gopls（语言服务器）和 dlv（调试器）最关键。如果跳过或安装失败，会出现“no debug adapter”或代码无补全。
• 手动安装最新版 dlv：
go install github.com/go-delve/delve/cmd/dlv@latest
• 检查是否成功：
dlv version 应输出版本号，且路径在 $GOPATH/bin 下• 在 VSCode 设置中确认启用了 LSP：
"go.useLanguageServer": true• 如果编辑器里 import 提示红色波浪线但
go build 正常，大概率是 gopls 没加载完，等几秒或重启 VSCode 窗口；持续失败可删掉 ~/.cache/go-build 和 $GOPATH/pkg/mod/cache 后重试
最容易被忽略的是：装完 .pkg 后没关再开终端，PATH 就不会更新；还有人把 GOPROXY 写成 https://goproxy.cn/（末尾斜杠导致 404）。这些小细节，比选哪个安装方式重要得多。
立即学习“go语言免费学习笔记（深入）”；
