只要go version能正常输出版本号，且go env GOPATH和go env GOROOT有合理路径，就已满足运行首个程序的最低要求；其余配置非必须，强行提前配置易出错。
只要 go version 能正常输出版本号，且 go env GOPATH 和 go env GOROOT 有合理路径，就已满足运行首个程序的最低要求——其余配置（如代理、IDE插件、GO111MODULE）不是必须项，强行提前配置反而容易出错。
验证 go 命令是否真正可用
很多人卡在“安装完了但 go run 报错”，其实根本没通过最基础的可用性检查：
- 打开全新终端（不要复用旧窗口），执行
go version；如果报'go' is not recognized或command not found，说明PATH没生效，重启终端或手动重载配置（Linux/macOS 执行source ~/.profile或source ~/.zshrc） - 接着运行
go env GOROOT和go env GOPATH，确认两者都返回非空路径；Windows 上常见错误是GOPATH显示为空，此时需手动设置（如setx GOPATH "%USERPROFILE%\go"），并新开终端验证 - 别跳过
go env全量输出——重点看GOOS（应为windows/darwin/linux）和GOARCH（通常amd64或arm64），若显示异常（如GOOS=""），说明环境变量解析失败
go run 失败的三个高频原因
写好 hello.go 后执行 go run hello.go 报错，90% 情况下是以下之一：
- 文件不在当前工作目录：终端 pwd/cd 到文件所在目录再运行，不要依赖 IDE 的“当前文件路径”假象
- 文件名含空格或中文：比如
我的第一个程序.go，Go 工具链对这类路径支持不稳定，改用纯英文+下划线命名（hello_world.go） - Go Modules 干扰：如果当前目录或父目录存在
go.mod，而该模块未初始化或依赖缺失，go run可能静默失败；临时解决：加-mod=mod参数，或直接删掉go.mod和go.sum
Windows 下 MSI 安装后仍找不到 go 的真实原因
官方 MSI 安装包确实会自动写入 PATH，但 Windows 有两处隐藏陷阱：
立即学习“go语言免费学习笔记（深入）”；
- 安装时若勾选了“Add Go to PATH for all users”，它会把路径写入系统变量
PATH；但如果你是普通用户登录，而系统管理员禁用了“用户可修改系统变量”，该路径实际不会被加载——此时需手动将%GOROOT%\bin加到用户级PATH - 某些安全软件（如 Windows Defender 应用控制策略）会拦截 MSI 的环境变量写入，表现为安装日志里提示“成功”，但
echo %PATH%里没有Go\bin；此时必须手动补全 - PowerShell 默认不继承 CMD 的环境变量缓存，安装后在 PowerShell 里首次运行前，先执行
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")强制刷新
真正卡住人的从来不是“怎么装”，而是装完后工具链和操作系统之间那几毫秒的环境变量同步延迟、路径解析歧义、以及模块系统对空目录的过度敏感——盯住 go env 输出，比反复重装更有效。
