go version报错说明PATH未包含Go的bin目录；Windows需检查系统环境变量Path是否含C:\Go\bin，macOS/Linux需确认echo $PATH输出含/usr/local/go/bin并执行source ~/.zshrc生效。
go version 命令报错或不识别，说明环境变量没生效
安装完 Go 后执行 go version 提示“不是内部或外部命令”或“command not found”，本质是 PATH 没包含 Go 的 bin 目录。
- Windows 用户检查系统环境变量
Path是否含C:\Go\bin（默认安装路径）；若改过安装路径，必须手动添加对应xxx\Go\bin - macOS/Linux 用户运行
echo $PATH，确认输出里有/usr/local/go/bin或你解压的路径（如/opt/go/bin）；没有就补上：export PATH=$PATH:/usr/local/go/bin，并写入~/.zshrc（M1/M2 默认）或~/.bashrc - 别漏掉
source ~/.zshrc（或对应 shell 配置文件），否则新开终端仍无效 - 验证时用全新终端窗口，不要复用安装前打开的终端
go mod init 报错 “unknown revision” 或依赖拉不下来
这是国内网络环境下最常见问题，go get 或 go mod download 卡住/失败，根本原因是模块代理未配置或失效。
- 优先设置国内代理：
go env -w GOPROXY=https://goproxy.cn,direct（推荐，稳定且支持私有模块） - 备选代理：
https://mirrors.aliyun.com/goproxy/，但部分旧版本 Go 对其 TLS 兼容性差 - 禁用代理仅用于调试：
go env -w GOPROXY=direct，但大概率失败，不建议长期用 - 如果项目已有
go.mod且含私有仓库路径（如git.example.com/internal/lib），需额外配置GOINSECURE：go env -w GOINSECURE=git.example.com
GOROOT 和 GOPATH 还需要手动设吗？
Go 1.16+ 默认启用 GO111MODULE=on，GOPATH 不再决定项目位置，GOROOT 通常由安装程序自动设好，99% 场景下无需干预。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
GOROOT：只在多版本共存或非标准路径安装时才需显式设置（如go env -w GOROOT=/opt/go-1.21） -
GOPATH：现代项目完全不用依赖它；只有极少数老工具（如某些go install的二进制）会读取$GOPATH/bin，可保留但不必纠结路径 - 真正要关注的是
GOBIN：若想统一存放编译出的命令行工具，设go env -w GOBIN=$HOME/bin并确保该路径在PATH中
VSCode 里 “Go: Install/Update Tools” 一直卡在 installing
VSCode 的 Go 插件依赖一系列 CLI 工具（gopls、dlv、goimports 等），它们默认从境外源下载，国内常超时。
立即学习“go语言免费学习笔记（深入）”；
- 先手动配置代理：
go env -w GOPROXY=https://goproxy.cn,direct（必须提前做） - 在 VSCode 设置里搜
go.toolsEnvVars，添加键值对："GOPROXY": "https://goproxy.cn" - 删掉
~/go/bin下已损坏的二进制（如gopls），再触发重装 - 如果仍失败，直接终端执行：
GO111MODULE=on go install golang.org/x/tools/gopls@latest（代理生效后这条能跑通）
GOPROXY 配一次，后续所有模块操作才真正“开箱即用”；很多人反复重装 Go 或换镜像站，却漏掉这一步，结果始终卡在第一步。 
