最常见问题是PATH未配置导致go command not found，需将/usr/local/go/bin加入PATH；GOPATH未设置会导致go install权限拒绝，应设为$HOME/go并创建src/bin/pkg目录；国内需配置GOPROXY镜像源避免模块下载失败；多版本共存时应避免手动设置GOROOT，优先依赖PATH顺序。
go command not found 是 PATH 没配对
这是最常卡住第一步的问题：终端敲 go version 报错 command not found。根本原因不是 Go 没装，而是系统压根没找到 go 这个二进制文件在哪。
Go 官方包解压后，可执行文件实际在 /usr/local/go/bin/go。你必须把这整个目录加进 PATH，否则 shell 就不认识 go 命令。
- 编辑
~/.zshrc（macOS Catalina 及以后默认用 zsh）或~/.bashrc（旧版 macOS 或 Linux） - 添加这一行：
export PATH=$PATH:/usr/local/go/bin - 执行
source ~/.zshrc（或对应文件）立即生效 - 再运行
go version，有输出就说明通了
别漏掉 /bin 后缀——写成 /usr/local/go 是无效的。
GOPATH 空着会导致 go install 权限拒绝
如果你运行 go install github.com/xxx/cli@latest 时遇到 permission denied，大概率是 GOPATH 没设，或者设了但没建好目录结构。
立即学习“go语言免费学习笔记（深入）”；
Go 默认会把编译出的二进制文件放进 $GOPATH/bin。如果 GOPATH 为空，它可能退回到 $GOROOT/bin——而那里是只读的（尤其在 /usr/local/go 下），自然写不进去。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 在 shell 配置文件里加：
export GOPATH=$HOME/go - 手动创建目录：
mkdir -p $GOPATH/{src,bin,pkg} - 把
$GOPATH/bin也加进PATH（顺序要靠前，否则可能被系统自带的旧版本覆盖）：export PATH=$GOPATH/bin:$PATH - 验证：
go env GOPATH应该输出/Users/xxx/go（macOS）或/home/xxx/go（Linux）
注意：GOBIN 不强制设，但一旦设了，go install 就只往那里写，不再看 GOPATH/bin。多数人直接靠 GOPATH 就够用。
国内网络下不配 GOPROXY，go mod tidy 就会卡死
Go 1.11+ 默认启用 module 模式，所有依赖都从 proxy.golang.org 拉。这个域名在国内基本不可达，go mod tidy 或 go get 会卡在 “Fetching dependencies…” 几分钟不动，最后超时失败。
- 配置镜像源（推荐
https://goproxy.cn或https://mirrors.aliyun.com/goproxy/）：export GOPROXY=https://goproxy.cn,direct - 加到 shell 配置文件，并
source生效 - 验证：
go env GOPROXY输出应为https://goproxy.cn,direct - 额外建议：顺手加上
export GOSUMDB=sum.golang.google.cn，避免 checksum 校验失败
别用 go env -w 写死全局配置——它会写进 $GOPATH/go.env，反而容易和 shell 环境变量冲突，尤其当你切换项目或使用 goenv 时。
多个 Go 版本共存时，which go 和 go version 对不上
你装了 Homebrew 的 Go，又手动解压了新版到 /usr/local/go，结果 which go 指向 /opt/homebrew/bin/go，但 go version 却显示旧版本。这是 PATH 中路径顺序混乱导致的。
- 运行
which go看命令实际来源 - 运行
go version看当前调用的是哪个二进制 - 检查
GOROOT是否被显式设置（比如export GOROOT=/usr/local/go）——如果它指向一个旧安装目录，而 PATH 里又混着多个go，Go 工具链会优先信任GOROOT而不是 PATH 找到的命令 - 稳妥做法：卸载 Homebrew 版（
brew uninstall go），统一用官方二进制包；或彻底清空GOROOT，让 Go 自动探测
GOROOT 通常不需要手动设——现代 Go 安装包会自动识别自身位置。强行指定反而容易锁死版本，尤其在用 goenv 切换版本时。
