go version报错或无输出说明PATH未包含GOROOT/bin，需先确认安装目录（如C:\Go\bin或/usr/local/go/bin）存在，再将其加入PATH并新开终端验证；GOROOT为空或错误则需手动设置并重载配置；go mod init失败多因GO111MODULE=off或项目位于GOPATH/src下；go run hello.go成功输出“ok”才证明环境完整可用。
go version 命令报错或无输出
这是最常见也最关键的失败信号。如果终端输入 go version 后提示 'go' 不是内部或外部命令，说明系统根本找不到 go 可执行文件——大概率是 PATH 没配对。
检查顺序必须是：先确认 Go 安装目录（比如 C:\Go\bin 或 /usr/local/go/bin）是否真实存在；再看该路径是否已加入 PATH；Windows 用户尤其注意不要漏掉 %GOROOT%\bin，且不能写成 C:\Go\（少了个 \bin）。
- Linux/macOS：运行
echo $PATH，搜go/bin字样 - Windows：在 CMD 中运行
echo %PATH%，或 PowerShell 中用$env:PATH - 别信“安装 MSI 就自动配好”的说法——某些杀毒软件或组策略会静默拦截环境变量写入
go env 输出 GOROOT 为空或路径错误
go env GOROOT 应该返回你实际安装 Go 的根目录，比如 C:\Go 或 /usr/local/go。如果为空、指向用户目录、或指向一个不存在的路径，go 工具链就无法定位标准库和编译器。
手动设置比依赖自动推导更可靠：
立即学习“go语言免费学习笔记（深入）”；
- Windows：在系统环境变量中显式添加
GOROOT，值为安装目录（不含\bin） - Linux/macOS：在
~/.bashrc或~/.zshrc中加一行export GOROOT=/usr/local/go - 改完务必重新加载配置（
source ~/.zshrc）或新开终端，否则go env仍读旧值
go mod init 失败或提示 “GO111MODULE=off”
这表示模块模式被禁用，通常是因为 GO111MODULE 环境变量被设为 off，或当前目录在 GOPATH/src 下（旧式 GOPATH 模式优先级更高）。
现代 Go（1.16+）默认启用模块，但若项目目录在 $GOPATH/src 内，go 会自动降级为 GOPATH 模式，导致 go mod init 报错或静默忽略。
- 运行
go env GO111MODULE，预期输出是on；如果不是，加export GO111MODULE=on到 shell 配置 - 初始化项目时，**不要**把代码放在
$GOPATH/src下，直接在任意空目录（如~/projects/hello）里执行go mod init hello - 验证是否生效：执行
go list -m，应输出模块名，而非command-line-arguments
go run hello.go 闪退或报 “cannot find package”
能跑 go version 和 go env 并不等于能编译运行代码。典型现象是窗口一闪而过，或报 cannot find package "fmt" —— 这说明 GOROOT 指向了空目录或权限受限位置。
真正有效的自测必须走完最小闭环：
- 新建目录，比如
mkdir ~/go-test && cd ~/go-test - 写
main.go：package main; import "fmt"; func main() { fmt.Println("ok") } - 执行
go run main.go，看到输出ok才算通过 - 如果失败，立刻检查
go env GOROOT返回的路径下是否存在src/fmt目录
GOROOT 错误往往不会在前几步暴露，只有到编译阶段才触发。别跳过这最后一步，它才是唯一可信的“环境活了”的证据。
