go version报错说明PATH未正确配置，需按系统差异添加go/bin路径并验证；Go Modules已默认启用，无需设置GOPATH；国内用户必须配置GOPROXY代理，且需用go env -w写入；gopls路径须与Go版本一致。
go version 命令报错或找不到，说明 PATH 没配对
这不是 Go 没装好，而是系统根本找不到 go 这个可执行文件。Windows、macOS、Linux 三者路径写法和生效方式差异很大，容易漏掉关键步骤。
- Windows：安装 .msi 后通常自动加
C:\Go\bin到系统 Path，但如果你手动解压 zip 包，必须自己把go\bin目录加到「系统环境变量 → Path」里 - macOS/Linux：多数人只改了
~/.zshrc或~/.bash_profile，却忘了执行source ~/.zshrc；或者用的是 fish/shell，配置文件压根不是这两个 - 验证方法不是看安装目录有没有
go文件，而是新开一个终端窗口，直接输go version—— 如果提示 command not found，就一定是 PATH 问题
go mod init 失败或提示 no modules found，别急着设 GOPATH
这是新版 Go（1.11+）最常被误操作的点。Go Modules 已默认启用，GOPATH 对普通项目已无作用，强行设置反而干扰依赖解析。
- 错误做法：新建项目还非得放到
$GOPATH/src/xxx下，或手动导出GOPATH环境变量 - 正确做法：在任意目录下运行
go mod init example.com/myapp，生成go.mod即可开始开发 - IDE 报 “cannot find package”？先运行
go mod tidy，而不是翻环境变量——模块依赖是按go.mod解析的，不是靠GOPATH查找路径
GOPROXY 不设，go get 就会卡在 golang.org/x/
国内用户不配代理，90% 的 go get 或 go mod download 都会超时失败，尤其涉及 golang.org/x/ 子库时。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 推荐配置（任选其一）：
go env -w GOPROXY=https://goproxy.cn,direct或go env -w GOPROXY=https://proxy.golang.org,direct - 别只改 shell 配置文件里的
export GOPROXY=...，要用go env -w写入 Go 自己的环境存储，否则go命令不认 - 顺带设一下
go env -w GOSUMDB=sum.golang.google.cn，避免校验失败导致模块下载中断
IDE 提示 gopls 启动失败或跳转失效，核心是工具链路径没对齐
VS Code、GoLand 都依赖 gopls（Go Language Server）提供智能提示和导航，但它必须和当前项目使用的 Go 版本一致，且路径不能指向旧版本或多个 Go 安装混用。
立即学习“go语言免费学习笔记（深入）”；
- 先确认 IDE 读取的是哪个
go：在 VS Code 中按Cmd+Shift+P（macOS）或Ctrl+Shift+P（Win/Linux），输入Go: Locate Configured Go Tools，检查输出中go和gopls路径是否指向同一安装目录 - 如果用了 asdf、gvm 等多版本管理器，确保 IDE 启动时加载了正确的 Go 版本（比如在项目根目录放
.tool-versions，内容为golang 1.22.0） -
gopls默认启用，但若手动关过，需检查设置项"go.useLanguageServer": true是否为true
go env，比反复重装更省时间。 
