PATH配置错位是最常见原因：macOS/Linux需配~/.zshrc（非.bashrc），Windows须在系统环境变量中设置；验证用which go，正确路径应含/bin；IDE需终端启动或手动指定GOROOT。
go command 找不到：PATH 配置错位是最常见原因
执行 go version 报 command not found，基本就是 PATH 没生效。不是“没配”，而是配了但 shell 没读到、或读错了文件。
- macOS / Linux 用户：zsh 默认不读
~/.bashrc，得改~/.zshrc；用 fish 的得配~/.config/fish/config.fish - Windows 用户：别在 cmd 里用
set GOPATH=...临时设置——重启就丢，必须进「系统属性 → 高级 → 环境变量」里设系统级或用户级变量 - 验证方式：运行
which go，输出应为/usr/local/go/bin/go或类似路径；若为空，说明 PATH 里根本没包含 Go 的 bin 目录 - 常见错误：写成
export PATH=$GOROOT:$PATH（漏了/bin），正确是export PATH=$GOROOT/bin:$PATH
go env 显示路径异常：GOROOT 和 GOPATH 不该手动乱设
go env GOROOT 输出不是你预期的安装路径（比如指向 /usr/lib/go 这种系统包管理器装的位置），或 go env GOPATH 是空的，说明环境变量逻辑混乱。
- GOROOT 大多数情况无需手动设——官方二进制包安装后会自动识别；只有解压到非标准路径（如
~/sdk/go1.22.5）才需显式 export - GOPATH 推荐保留默认值（
~/go），不要为了“项目隔离”硬改成多个路径拼接（如/a:/b:/c），gopls、dlv 等工具对多目录 GOPATH 支持不稳定 - 检查是否误删了 GOPATH 下的
pkg/mod目录——这会导致go mod download反复失败，但go env仍显示正常 - 如果用了
goenv或g切换版本，注意它们会动态改 GOROOT，此时go env GOROOT应与当前激活版本一致
依赖拉取卡死或 403：GOPROXY 不只是可选项，而是必选项
国内环境下，go mod tidy 卡在 Fetching github.com/xxx 或报 proxy.golang.org:403，99% 是没设 GOPROXY。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 必须设：运行
go env -w GOPROXY=https://goproxy.cn,direct（direct表示回源，避免私有模块被代理拦截） - 别用
https://goproxy.io—— 已停服；也别只设https://goproxy.cn不加,direct，否则私有仓库模块无法拉取 - 企业内网用户若禁外网，可搭自建 proxy（如 Athens），但必须确保其支持
go list -m -json等 v2 module discovery 协议 - 临时绕过代理仅用于调试：加
-o参数跑go mod download -o /dev/null github.com/xxx，看是否真因网络失败
IDE 启动后 go 命令失效：终端和 GUI 应用加载环境不同步
终端里 go version 正常，但 VS Code 或 Goland 里提示 “go command not found”，是因为 GUI 应用不继承 shell 的环境变量。
立即学习“go语言免费学习笔记（深入）”；
- VS Code：用命令行启动——
code .而不是双击图标；或在settings.json中设"go.gopath": "/home/user/go"和"go.goroot": "/usr/local/go" - GoLand：Preferences → Go → GOROOT 里手动指定路径；不要依赖 “Auto-detect” —— 它有时会选错系统包管理器装的旧版 Go
- macOS 上通过 Launch Services 启动的 App（如从 Dock 点开）默认只读
~/.MacOSX/environment.plist，已弃用；稳妥做法是统一用终端启动 IDE - 验证方式：在 IDE 内置终端执行
echo $PATH，对比外置终端输出，差在哪一截就补哪一截
,direct 后缀——前者导致工具链失联，后者导致私有模块拉取失败。 
