Go安装失败多因环境问题：PATH未正确配置、~/go目录权限属root、GOPROXY未启用、GOROOT/GOPATH拼写或路径错误；应依次检查路径、权限、代理及环境变量。
Go 安装失败，90% 的情况不是 Go 本身的问题，而是环境没对齐——系统权限、网络代理、路径归属、变量拼写这四点卡住绝大多数人。
command not found: go —— PATH 没加对或加错了位置
这是最常见现象：明明解压了 /usr/local/go，但终端一敲 go version 就报错。根本原因不是没装，而是 shell 根本找不到 go 可执行文件。
- 确认 Go 二进制真实路径：
ls /usr/local/go/bin/go（Linux/macOS）或dir C:\Go\bin\go.exe（Windows） - PATH 必须包含
/usr/local/go/bin（macOS/Linux）或C:\Go\bin（Windows），不能只加/usr/local/go - Zsh 用户改
~/.zshrc，Bash 用户改~/.bashrc或~/.bash_profile；改完必须运行source ~/.zshrc - 验证是否生效：
echo $PATH | grep -o "/usr/local/go/bin"（应有输出）
Permission denied 写入 ~/go —— 目录归属被 root 占了
用 sudo tar 解压、或用 sudo ./install.sh 脚本安装后，~/go 下的 pkg、bin、src 目录可能归 root 所有，导致后续 go install 或 go mod download 失败。
- 检查权限：
ls -ld ~/go，若显示root在 owner 列，就是它 - 修复命令：
sudo chown -R $(whoami) ~/go - 更稳妥做法：从一开始就避免
sudo，把 Go 装到用户目录，比如tar -C $HOME -xzf go1.21.6.linux-amd64.tar.gz，再设GOROOT=$HOME/go - 顺手清理旧缓存：
go clean -modcache，否则残留的 root 权限模块仍会报错
go: failed to download golang.org/x/... —— 网络不通 + GOPROXY 没开
国内用户不配代理，go get 或 go mod tidy 基本必挂，错误里常带 dial tcp: i/o timeout 或 proxy.golang.org 字样。
立即学习“go语言免费学习笔记（深入）”；
- 必须启用 Go Modules（即使项目没
go.mod）：go env -w GO111MODULE=on - 设国内代理（推荐七牛）：
go env -w GOPROXY=https://goproxy.cn,direct - 跳过私有域名（如公司内网 Git）：
go env -w GOPRIVATE=git.example.com - 禁用校验仅用于调试：
go env -w GOSUMDB=off（上线前务必关掉）
GOROOT 和 GOPATH 拼写/路径冲突 —— 多个配置互相打架
变量名写成 GOOROT、GOPATHH，或在 .zshrc 里写了两遍 export GOROOT=... 且值不同，会导致 go env 输出混乱，工具链行为异常。
- 统一查看当前生效值：
go env GOROOT GOPATH（别用echo $GOROOT，它可能和 go 实际用的不一致） - GOROOT 应指向 Go 安装根目录（含
src、bin子目录），不是bin目录本身 - GOPATH 推荐设为
$HOME/go，并确保该路径存在：mkdir -p $HOME/go/{src,bin,pkg} - 如果用 Homebrew 装 Go（
brew install go），GOROOT通常自动设为/opt/homebrew/opt/go/libexec（Apple Silicon）或/usr/local/opt/go/libexec（Intel），不要手动覆盖
真正麻烦的从来不是“装不上”，而是装上了但部分功能失效——比如 go run 成功，go install 却提示 permission denied，或者编辑器里代码能跑但没补全。这种时候，先盯死 go env 输出，再看对应目录的 ls -l，比重装十次都管用。
