优先查 go env 和 go version；PATH 未配置会导致 go version 报错；GOPATH 空值在模块模式下非致命；用 go run -e 验证工具链；go help 和 go doc 提供离线帮助。
遇到环境问题，优先查 go env 和 go version，而不是盲目重装。
执行 go version 报错或无输出
说明 PATH 没配对，/usr/local/go/bin（Linux/macOS）或 C:\Go\bin（Windows）根本没进系统路径。
- Linux/macOS：检查
~/.bashrc或~/.zshrc里是否真有export PATH=$PATH:/usr/local/go/bin，然后运行source ~/.zshrc（别漏掉这步） - Windows：在 PowerShell 里运行
$env:Path，确认C:\Go\bin出现在输出中；若没有，用系统设置里的“环境变量”图形界面添加，别只改命令行临时变量 - 常见假成功：终端新开一个窗口后没重新加载配置，导致
go version找不到命令
go env GOPATH 显示空值或奇怪路径
说明 GOPATH 没生效，或被 GO111MODULE=on 隐蔽影响——但现代 Go（1.16+）已默认启用模块模式，GOPATH 对日常开发实际影响变小，除非你手动 go get 老包或用 go install 安装命令行工具。
- 想确认模块是否启用：运行
go env GO111MODULE，输出应为on；若为auto或off，可能在非模块目录下触发旧行为 -
GOPATH空不是致命问题：只要go run、go build能跑，且项目根目录有go.mod，就不用强求GOPATH有值 - 误删
$HOME/go目录后go install失败？补上mkdir -p $HOME/go/bin并确保该路径在PATH中即可
想快速验证环境是否真可用，别写 hello.go
直接跑官方最小验证命令，绕过文件创建和编辑器环节：
立即学习“go语言免费学习笔记（深入）”；
go run -e 'package main; import "fmt"; func main() { fmt.Println("OK") }'
这条命令会即时编译并执行内存中的代码。如果输出 OK，说明 Go 工具链、编译器、标准库全通；如果报错，错误信息比 go version 更具体（比如缺 libc、权限不足、CGO_ENABLED 冲突等）。
- Linux 上常见失败原因：
libgcc或glibc版本太低（尤其 Alpine 镜像），此时go version可能正常，但go run会卡住或报cannot execute binary file - macOS 上 M1/M2 芯片用户：确认下载的是
arm64版安装包，不是amd64；go version输出里应含darwin/arm64
官方文档和实时帮助入口必须记牢
所有命令自带内建帮助，不依赖网络或浏览器：
- 查命令用法：
go help build、go help mod、go help environment - 查环境变量含义：
go help environment会列出GOPATH、GOROOT、GO111MODULE等全部说明 - 查标准库函数：
go doc fmt.Println直接输出函数签名和文档，支持离线使用 - 别迷信搜索引擎结果：很多老教程教改
GOROOT，但现代 Go 安装后GOROOT通常自动设好，手动改反而容易出错
真正卡住时，复制完整错误信息 + go env 输出，贴到 golang-nuts 邮件列表或 GitHub 的 golang/go issues 里，比问“怎么装 Go”有效得多。
