Go环境是否装对，三步断定：能运行go version、能读取go env、能执行go run main.go；缺一不可，任一失败均表明配置错误或工具链不完整。
Go 环境是否装对了，不用猜，三步就能断定：能跑 go version、能读 go env、能执行 go run main.go —— 缺一不可。
go version 命令报错或找不到？PATH 配得不对
这是最常见也最基础的卡点。如果终端输入 go version 提示 'go' is not recognized（Windows）或 command not found（macOS/Linux），说明系统根本找不到 go 二进制文件。
- Windows 用户检查安装时是否勾选了
Add Go to PATH；若用 MSI 安装却没勾，就得手动把C:\Go\bin加进系统环境变量Path - macOS/Linux 用户重点看
~/.zshrc或~/.bash_profile里有没有这行：export PATH=$PATH:/usr/local/go/bin（路径要和你实际解压位置一致） - 改完配置别忘了重开终端，或者运行
source ~/.zshrc让它生效
go env 显示 GOROOT 为空或指向项目目录？安装路径污染了
go env GOROOT 应该指向 Go 的安装根目录（比如 /usr/local/go 或 C:\Go），而不是你放代码的文件夹。如果它为空、是空字符串，或者指向了 ~/myproject 这类路径，基本等于把项目目录误设成了 GOROOT。
- 手动删掉错误的
GOROOT环境变量（不要在 shell 配置里硬写） - 让 Go 自己推导：不设
GOROOT，只要go命令能执行，它会自动定位到安装目录下的src和pkg - 验证方式：
ls $GOROOT/src/fmt（Linux/macOS）或dir %GOROOT%\src\fmt（Windows）—— 如果提示“找不到”，说明GOROOT指向无效
go run main.go 报 “package not in GOROOT”？模块模式没开或路径乱了
这个错误常出现在刚写完 main.go 就执行 go run main.go 却失败时。本质是 Go 不知道该用老式 GOPATH 模式还是新式 module 模式来构建。
- 先确认是否启用了 module 模式：
go env GO111MODULE输出应为on（Go 1.16+ 默认开启） - 如果输出是
auto或off，临时强制开启：go env -w GO111MODULE=on - 然后在
main.go所在目录运行go mod init example.com/hello初始化模块，再试go run main.go - 别把
main.go放进$GOPATH/src下再用旧方式跑——现代 Go 已不依赖此结构，反而容易触发冲突
真正容易被忽略的是：即使 go version 和 go env 都正常，go run 仍可能因缺失 GOROOT/src（比如手动删过或解压不全）而静默失败。建议顺手跑一句 go list std | head -n 3，能看到标准库包列表才算工具链完整。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
