应修正PATH中go命令的优先级，将新版Go的bin目录（如/usr/local/go/bin）前置，避免旧版go（如/usr/bin/go）被优先调用导致GOPATH等环境变量解析异常。

which go 和 go version 输出不一致怎么办

这说明系统里存在多个 go 可执行文件，PATH 里有冲突路径。常见于旧版残留、多版本共存或手动解压未清理干净。

• 先执行 which go 看当前生效路径，再执行 /usr/local/go/bin/go version、~/go/bin/go version 等常见位置，比对版本
• 检查 echo $PATH，确认是否有重复或错误的 /usr/local/go/bin、$GOPATH/bin、~/sdk/go1.22.2/bin 等
• 临时排除干扰：运行 env -i PATH=/usr/bin:/bin /usr/local/go/bin/go version，验证是否是环境变量污染导致

GOROOT 被错误手动设置后命令失效

GOROOT 不该随便设——官方安装包（.msi/.pkg）和 tar -C /usr/local -xzf 解压后，go 自己就能找到标准库位置。手动设错反而会破坏交叉编译、go tool 查找等能力。

• 删掉 shell 配置文件（~/.bashrc、~/.zshrc）里所有 export GOROOT=... 行
• 执行 go env GOROOT，正常应输出 /usr/local/go（Linux/macOS）或 C:\Program Files\Go（Windows）
• 如果仍异常，说明 go 二进制本身可能来自非标准安装（如 snap 或旧 rpm），建议彻底卸载后重装官方 .tar.gz

PATH 混乱导致 go 命令找不到或 gopls 启动失败

VS Code 的 gopls 依赖终端启动时的环境变量；但 GUI 应用（如 GoLand、VS Code 图形界面）往往不读 ~/.bashrc，而读 ~/.profile 或 ~/.zprofile，尤其在 macOS zsh 下。

Golang Spf13 Viper

Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。

下载

• Linux 用户：统一把 PATH 添加写入 ~/.profile（被大多数桌面环境加载），再在 ~/.bashrc 或 ~/.zshrc 里加 source ~/.profile
• macOS 用户：zsh 默认不读 ~/.bashrc，必须改 ~/.zshrc；若用 VS Code 图形版，重启前要执行 code --no-sandbox --disable-gpu 或从终端启动：code .
• 验证方式：在终端运行 go env GOPATH 和在 VS Code 终端里运行结果必须一致；不一致就说明 IDE 没继承到正确环境

GO_PROXY 或 GO111MODULE 设置被覆盖或失效

这些变量常被 IDE 插件、shell 别名、甚至某些脚本临时覆盖，表现为 go mod download 卡住，但 go env GO_PROXY 显示正常。

立即学习“go语言免费学习笔记（深入）”；

• 别用 export GO_PROXY=... 写在配置文件末尾——把它放在最前面，避免被后续 alias 或函数覆盖
• 检查有没有 alias go='go env -w GO111MODULE=on; go' 这类危险 alias，它会让每次 go 执行都触发写操作，极慢且不可靠
• 运行 go env -w GO111MODULE=on 和 go env -w GOPROXY=https://goproxy.cn,direct 是持久化方式，比 export 更稳，且会被所有子进程继承

环境变量混乱的本质不是“设少了”，而是“设多了、设乱了、设错了时机”。最省事的起点永远是：删掉所有自定义 GOROOT，只留一条 PATH 指向唯一 go 二进制目录，再用 go env -w 设置模块相关变量——其他全是干扰项。