go安装成功需依次验证：1. go version输出预期版本；2. path含goroot/bin且无多版本冲突；3. goroot指向安装根目录、goenv可写；4. go run main.go输出"hello, go"；5. go mod init与go mod tidy成功拉取依赖。
go version 输出是否匹配预期版本
安装完 Go 后第一件事不是写代码，而是确认 go version 输出的版本号和你下载/安装的目标版本一致。常见错误是系统 PATH 中残留旧版 Go 的 bin 目录，导致终端里执行的是老版本。
执行：go version
应输出类似 go version go1.22.5 linux/amd64（具体以你安装版本为准）。若显示 go version go1.19.12 或报错 command not found: go，说明环境变量没生效或安装路径未加入 PATH。
- 检查
$GOROOT是否指向你解压/安装的 Go 根目录（如/usr/local/go或$HOME/sdk/go） - 确认
$PATH包含$GOROOT/bin，且该路径在其他 Go 路径之前（避免冲突） - Linux/macOS 下修改
~/.bashrc或~/.zshrc后需执行source ~/.zshrc生效
GOOS 和 GOARCH 是否被意外覆盖
Go 编译默认生成当前系统平台的二进制，但如果你设过 GOOS 或 GOARCH 环境变量（比如交叉编译后忘了清理），后续 go build 会静默产出非本地可执行文件，运行时报 cannot execute binary file: Exec format error。
验证方式：echo $GOOS $GOARCH
正常应为空（即未设置），或等于当前系统值（如 linux amd64）。若输出非空且非当前平台，建议临时 unset：unset GOOS GOARCH
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 不要在 shell 配置文件中永久导出这两个变量，除非你明确需要默认交叉编译
-
go env -w GOOS=xxx是持久化设置，用go env -u GOOS可撤销 - CI/CD 脚本中设了这些变量，本地调试时容易忽略其影响
go env 输出中 GOPATH 是否合理
Go 1.11+ 默认启用模块（module）模式，GOPATH 不再是必须项，但某些工具（如旧版 gopls、部分插件）仍会读取它。若 GOPATH 指向一个不存在的路径，或权限不足的目录，会导致 go install 失败或缓存异常。
运行：go env GOPATH
典型值为 $HOME/go（Linux/macOS）或 %USERPROFILE%\go（Windows）。检查该路径是否存在、可读写：
- 若路径不存在，手动创建：
mkdir -p $(go env GOPATH) - 若路径存在但属主不对（如 root 创建、当前用户无写权限），
chmod 755或chown修复 - 不建议把
GOPATH设为系统级路径（如/usr/local/go），易引发权限问题
模块代理与校验是否启用
国内环境常因网络问题卡在 go mod download，但更隐蔽的问题是：即使能下载，若 GOSUMDB 验证失败或代理返回篡改包，go build 会直接报错 checksum mismatch，且不提示具体哪个 module 出问题。
检查关键配置：go env GOSUMDB —— 应为 sum.golang.org 或 off（开发阶段可临时关掉）go env GOPROXY —— 推荐设为 https://proxy.golang.org,direct 或国内镜像（如 https://goproxy.cn,direct）
- 若使用自建代理或私有仓库，确保
GOPRIVATE正确设置了匹配域名（如git.example.com/*） -
go clean -modcache可清除损坏的模块缓存，再重试go mod download - 校验失败时，
go mod verify能定位具体 module，比盲目删缓存更高效
GOOS/GOARCH 和 GOPROXY/GOSUMDB 的组合状态，往往比重装 Go 更快定位根源。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
