go命令可用且版本正确需满足：PATH包含Go的bin目录、go version输出≥1.21、GO111MODULE=on、GOPATH存在且有效；执行go mod init + go run main.go输出“Hello, Go!”即模块化环境就绪。
验证 go 命令是否可用且版本正确
环境变量配置后最常出问题的是 PATH 没生效，或装了多个 Go 版本导致 go version 输出意外结果。直接运行：
go version
预期输出类似 go version go1.22.3 darwin/arm64（系统和架构因人而异）。若报错 command not found: go，说明 PATH 未包含 Go 的 bin 目录；若版本过低（如 go1.16），可能不支持泛型、go.work 等现代特性，建议升级到 1.21+（LTS）或最新稳定版。
检查 GOPATH 和模块模式是否正常启用
Go 1.16+ 默认启用模块模式（GO111MODULE=on），但部分旧项目或误配的 GOPATH 会干扰初始化。运行：
go env GOPATH GO111MODULE
典型健康输出应为：
立即学习“go语言免费学习笔记（深入）”；
GOPATH=/Users/xxx/go GO111MODULE=on
-
GOPATH应指向一个实际存在的目录（不必手动创建，go mod init会用到） -
GO111MODULE必须是on或空（空值在 1.16+ 中等效于on）；若为off，则模块功能被禁用，go get会尝试写入GOPATH/src，极易出错 - 临时修复：执行
go env -w GO111MODULE=on
快速跑通一个模块化 Hello World
这是检验模块初始化、依赖解析、构建执行三环节是否连通的关键测试。在任意空目录中执行：
go mod init hello
echo 'package main\n\nimport "fmt"\n\nfunc main() { fmt.Println("Hello, Go!") }' > main.go
go run main.go
若输出 Hello, Go!，说明一切就绪。常见失败点：
-
go mod init报错cannot determine module path→ 当前目录含非法字符（如空格、中文）或位于GOPATH/src下，换纯英文路径重试 -
go run卡住或超时 → 检查代理设置（go env GOPROXY，国内推荐https://goproxy.cn或https://proxy.golang.org） - 输出
hello而非Hello, Go!→ 说明main.go未被识别为可执行包，确认文件名是main.go且 package 是main
验证常用开发依赖能否安装
仅能跑 go run 不代表生态可用。试试装一个高频工具：
go install golang.org/x/tools/cmd/goimports@latest
成功后检查是否可调用：
goimports -h
若提示 command not found，说明 GOBIN（或默认 $GOPATH/bin）未加入 PATH；若报 proxy 错误或 timeout，需配置代理：
go env -w GOPROXY=https://goproxy.cn,direct
注意：go install 后生成的二进制默认放在 $GOBIN（若未设，则为 $GOPATH/bin），这个路径必须在 shell 的 PATH 中才可全局调用。
最容易被忽略的是 GOBIN 和 PATH 的联动，以及 GO111MODULE=off 在子 shell 中悄悄复位——建议新开终端窗口验证，别只信当前 shell 的 env 输出。
