macOS 上 Golang 环境真正就绪的标志是 go 命令能在终端直接运行——需确认 shell 类型（zsh/basH）、将 /usr/local/go/bin 加入对应配置文件 PATH、配置 GOPROXY（如 https://goproxy.cn）、并用 go version、go env 和 go run 测试闭环。
go 命令能直接在终端运行，才是 macOS 上 Golang 环境真正就绪的标志——不是装完.pkg 就算完事，关键在 PATH 是否生效、是否匹配你当前 shell。
确认你用的是 zsh 还是 bash
macOS Catalina（10.15）起默认 shell 是 zsh，但如果你升级过系统或手动改过 shell，可能仍是 bash。执行以下命令一眼看清：
echo $SHELL
输出 /bin/zsh → 编辑 ~/.zshrc；输出 /bin/bash → 编辑 ~/.bash_profile。很多人装完 go version 报错 command not found，就是改错了文件。
安装后必须检查 /usr/local/go/bin 是否在 PATH 中
官方 .pkg 安装器会尝试自动配置 PATH，但它只对新打开的终端生效，且不保证写入你正在用的 shell 配置文件。最稳妥的做法是手动加一行：
- 用
nano ~/.zshrc（或对应配置文件）打开 - 末尾添加：
export PATH=$PATH:/usr/local/go/bin - 保存后立即生效：
source ~/.zshrc - 验证：
echo $PATH | grep "local/go/bin"—— 有输出才算落进去了
GOPATH 不再强制，但 GOPROXY 必须配（尤其在国内）
Go 1.11+ 默认启用 modules，GOPATH 对项目结构已无硬性约束，但国内拉依赖极慢甚至超时，不配代理几乎无法开发：
GitHub Actions Secret Exposure Audit
下载
审计 GitHub Actions 工作流文件的密钥泄露风险，例如 pull_request_target 密钥使用、密钥回显命令及未固定版本的 Action 密钥传递。
立即学习“go语言免费学习笔记（深入）”；
go env -w GOPROXY=https://goproxy.cn,direct<br>go env -w GOSUMDB=sum.golang.google.cn
这两条只需运行一次。之后 go mod download 或 go get 就不会卡在 Fetching github.com/xxx 上。如果公司内网，可换成自建 athens 地址。
验证环境是否真可用：别只跑 go version
go version 只说明二进制存在，不代表模块、网络、工作区都正常。建议三步连验：
-
go version→ 看版本号和darwin/arm64或amd64架构是否匹配你的 Mac 芯片 -
go env GOPATH GOROOT→ 确认GOROOT是/usr/local/go，GOPATH是预期路径（默认$HOME/go） - 新建测试项目：
mkdir ~/test-go && cd ~/test-go<br>go mod init example.com/test<br>go run <(echo 'package main; import "fmt"; func main() { fmt.Println("OK") }')→ 输出OK才算闭环
amd64 包），以及终端没重载配置就急着验证。装完别关终端，source 一下，再敲命令。 
