macos 上 go 环境搭建失败主因是 path 未正确配置、gopath 目录结构缺失或多个 go 版本冲突；需验证 which go、source 配置文件、创建 $gopath/src 等必要目录，并统一管理版本。
macOS 上 Go 环境搭不起来，八成是 PATH 没配对、GOPATH 没生效，或者多版本冲突 —— 不是 Go 本身难，是环境变量和路径逻辑容易错漏。
go 命令找不到？先查 PATH 和安装路径
执行 go version 报 command not found: go，说明 shell 根本没找到二进制文件。官网下载包默认装在 /usr/local/go/bin，但 macOS 不会自动加进 PATH。
- 运行
which go，如果无输出，确认是否真装了：检查/usr/local/go是否存在 - 编辑
~/.zshrc（Zsh 默认）或~/.bash_profile（Bash），追加：export PATH=$PATH:/usr/local/go/bin - 保存后必须执行
source ~/.zshrc，否则配置不生效 - 验证：新开终端窗口再跑
go version，不能只在当前 tab 里反复 source
GOPATH 不生效？别跳过 src 目录初始化
Go 1.11+ 虽支持 module 模式，但很多老项目、工具链（如 go get 安装 CLI 工具）仍依赖 GOPATH。设了变量却提示 GOPATH not set，往往是目录结构缺失。
- 在配置文件中添加两行：
export GOPATH=$HOME/goexport PATH=$PATH:$GOPATH/bin - 手动创建必要子目录：
mkdir -p $GOPATH/src $GOPATH/bin $GOPATH/pkg - 注意：不能只设
GOPATH就完事，$GOPATH/src是go get下载源码的默认落点，缺了它某些命令会静默失败
多个 Go 版本共存？用 which go 和 brew unlink 清理残留
Homebrew 装的 Go 和官网 pkg 安装的 Go 可能同时存在，go version 显示的版本和 which go 返回的路径不一致，就是典型冲突。
- 先看实际调用的是哪个：
which go→ 如果是/usr/local/bin/go，大概率是 Homebrew 版which go→ 如果是/usr/local/go/bin/go，则是官网版 - 统一用 Homebrew 管理更省心：
brew install go（首次）或brew upgrade go（更新） - 删掉官网旧版：
sudo rm -rf /usr/local/go，再删掉原PATH里指向它的那一行 - 清理后重启终端，确保
which go和go version输出路径一致
真正卡住人的往往不是 Go 本身，而是 shell 配置没 reload、src 目录没建、或者两个 go 二进制打架。每一步都得验证落地结果，而不是只改配置就以为搞定了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
