90%的“go命令找不到”是PATH未正确配置所致，需将/usr/local/go/bin（非/usr/local/go）加入PATH并source生效；权限问题应避免sudo解压，改用chown修复；网络问题需开启GO111MODULE、设置GOPROXY和GOPRIVATE；GOROOT/GOPATH拼写或重复设置会导致冲突，须逐一验证。
go 命令找不到，90% 是 PATH 没加对，不是 Go 没装好。
command not found: go —— PATH 配置错位最常见
你解压了 /usr/local/go，但敲 go version 报错，不是没装，是 shell 根本没看到 go 这个文件。
- 先确认二进制真实存在：
ls /usr/local/go/bin/go（Linux/macOS）或dir C:\Go\bin\go.exe（Windows） - PATH 必须包含
/usr/local/go/bin（不能只写/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，如果 owner 列显示root，就是它 - 修复命令：
sudo chown -R $(whoami) ~/go - 更稳妥做法：从一开始就避免
sudo，比如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 字样。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 必须启用 Modules：
go env -w GO111MODULE=on（即使项目没go.mod也得开） - 设国内代理（推荐七牛）：
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，输出必须是你安装 Go 的真实路径（比如/usr/local/go） - 搜所有 shell 配置：
grep -r "GOROOT\|GOPATH" ~/.zshrc ~/.bashrc ~/.profile 2>/dev/null - Windows 用户注意：系统变量和用户变量里不要同时设置
GOROOT，优先用用户变量；PATH 中重复添加C:\Go\bin也会干扰
真正卡住人的，往往不是某一步错了，而是多个小配置叠加失效——比如 PATH 加对了但 GO111MODULE 关着，或者 GOPROXY 设了但 GOPRIVATE 漏了公司域名。每次改完一个点，都该用 go env 和 go version 实时验证，别攒一堆改动一起试。
