go命令找不到的根本原因是PATH未包含Go的bin目录，需根据shell类型编辑~/.zshrc或~/.bash_profile添加对应路径（如/opt/homebrew/bin或/usr/local/go/bin），再执行source生效；which go有输出且go version成功才表示配置正确。
go 命令找不到：PATH 没配对
终端敲 go version 提示 command not found: go，不是没装好，而是 shell 根本不知道 go 在哪。Homebrew 安装的 Go 默认路径是 /opt/homebrew/bin/go（Apple Silicon）或 /usr/local/bin/go（Intel），但 macOS 不会自动把它加进 PATH。
确认当前 shell 类型：echo $SHELL，大概率是 zsh。编辑 ~/.zshrc，追加这行：
export PATH=$PATH:/opt/homebrew/bin
如果是 Intel Mac 或手动安装，路径可能是 /usr/local/go/bin，那就写成：
export PATH=$PATH:/usr/local/go/bin
- 改完必须执行
source ~/.zshrc才生效 - 别只改
~/.bash_profile—— macOS Catalina 之后默认不用 bash -
which go要能输出路径，才算真正“被识别”
GOPATH 还要不要设？现代 Go 的真实情况
Go 1.11 引入模块（go mod）后，GO111MODULE=on 已成默认，GOPATH 对依赖管理不再关键。但某些老工具（比如部分 IDE 插件、gopls 旧版本）或私有代码仓库仍会读取它。
立即学习“go语言免费学习笔记（深入）”；
如果你用的是 Go 1.16+，且项目根目录有 go.mod，那 go build、go run 全部绕过 GOPATH。但建议仍设一个干净的 GOPATH，避免意外干扰：
export GOPATH=$HOME/go
- 不需要再手动
mkdir -p $GOPATH/src—— 新版 Go 不强制要求这个结构 - 别把项目直接放
$GOPATH/src下，现代项目应独立于GOPATH - 如果报
GOPATH not set，不是编译失败，而是某个工具在找它，设了就行
多个 Go 版本共存时，which go 指向谁？
你可能同时装过 Homebrew 版、官网 pkg 版、甚至 gvm 管理的版本。终端里 go version 和 which go 输出不一致，或者 brew upgrade go 后版本没变，说明路径冲突了。
先查清楚当前 go 来自哪：
which go
再看它实际指向：
ls -l $(which go)
- 如果指向
/usr/local/go/bin/go，但你想用 Homebrew 版，就删掉旧目录：sudo rm -rf /usr/local/go - Homebrew 安装的
go是软链接到/opt/homebrew/Cellar/go/x.y.z/bin/go，不要手动替换 - 临时切换版本可用
export PATH="/opt/homebrew/Cellar/go/1.21.0/bin:$PATH"，但别写死在配置文件里
go mod download 失败：代理和校验问题
执行 go mod download 卡住、超时，或提示 verifying github.com/xxx@v1.2.3: checksum mismatch，大概率是模块代理或校验机制出问题。
国内开发者基本要配代理：
go env -w GOPROXY=https://proxy.golang.org,direct
更稳妥的国内镜像：
go env -w GOPROXY=https://goproxy.cn,direct
- 加
,direct表示对私有域名（如公司内网 git）跳过代理，走直连 - 校验失败时，先清缓存：
go clean -modcache，再重试 - 如果项目用了私有模块，确保
go env -w GONOPROXY=git.internal.company.com配对正确
环境变量不是设完就一劳永逸的——每次开新终端都要重新加载，go 的路径、代理、模块行为都依赖这些值是否实时生效。最容易漏的是 source 那一步，以及没意识到不同 shell（zsh/bash/fish）配置文件完全独立。
