装完Go不能只信go version有输出，还需验证GOROOT、GO111MODULE、GOPROXY、$GOPATH/bin在PATH中四项配置，并确保模块拉取、工具安装与命令调用全部畅通。
装完 Go 不能只信 go version 有输出，它只是“命令能敲出来”，不代表编译、模块、代理、工具链全通。真正要跑项目，至少得过四关：二进制路径对、环境变量准、模块能拉、工具可调用。
验证 go 命令是否指向你装的版本
很多人装了新版本却还在用旧版，是因为 PATH 里旧路径排在前面。
- 运行
which go（Linux/macOS）或where go（Windows），确认输出是你要的路径，比如/usr/local/go/bin/go - 再执行
go env GOROOT，输出必须和上面路径的父目录一致（/usr/local/go），否则就是环境变量设错了 - 如果
go env GOROOT是空，或指向$HOME/go这类明显不对的位置，说明手动设置了错误值；可用go env -w GOROOT=""清掉，让 Go 自行推导
检查模块模式与代理是否就绪
GO111MODULE=off 或 GOPROXY 不可用，会导致 go mod init 无反应、go run 找不到外部包。
- 运行
go env GO111MODULE，结果必须是on；若为auto或空，执行go env -w GO111MODULE=on - 运行
go env GOPROXY，国内推荐值应为https://goproxy.cn,direct；若为空或https://proxy.golang.org,direct，大概率go get超时 - 新建临时目录，执行
go mod init testenv && go get golang.org/x/net/html，不报cannot find module才算真通
确认 go install 生成的命令能全局调用
IDE 报 “Failed to start gopls” 多半不是插件问题，而是 gopls 没装上，或装了但找不到。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 执行
go install golang.org/x/tools/cmd/gopls@latest，成功后不报错 - 立即运行
gopls version，能输出版本号才算闭环；如果提示command not found，说明$GOPATH/bin没进PATH - 检查
go env GOPATH输出的路径，再确认该路径下的bin/子目录是否在PATH中（例如export PATH="$GOPATH/bin:$PATH"）
跑通最小构建 + 运行闭环
go run 成功 ≠ go build 可调试 ≠ 项目可交付，三者依赖不同能力链。
- 写一个最简
main.go，只含fmt.Println("ok")，确保当前目录无go.mod也能go run main.go - 在同一目录执行
go build -o hello .，生成文件后运行./hello，输出一致才算构建通 - 如需后续用 dlv 调试，必须用
go build -gcflags="all=-N -l" -o hello .，go run默认不带调试符号
最容易被忽略的是 go env -w 写入是否生效——它依赖 GOENV 可写且未被禁用；如果 go env -w GOPROXY=xxx 后 go env GOPROXY 没变，先查 go env GOENV 是否指向有效路径，再试 go env -u GOPROXY 看能否清掉，否则所有配置都是假的。
