go version命令无输出或报错说明go未被系统识别，根本原因是path未正确配置：windows需重启终端，linux/macos需添加export path=$path:/usr/local/go/bin并source，避免安装路径含空格；goroot错误会导致fmt等标准库找不到，应设为真实安装路径如/usr/local/go或c:\go；go run报cannot find package "fmt"多因goroot指向错误或标准库缺失；go mod init后go list -m无输出需检查go111module是否为on、当前目录是否在gopath/src下、goproxy是否配置国内代理。
go version 命令无输出或报错
这是最前置的判断点：如果终端输入 go version 直接提示 command not found（Linux/macOS）或 'go' 不是内部或外部命令（Windows），说明 Go 二进制没进 PATH，根本没被系统识别。
常见原因：
- Windows 安装 .msi 后没重启 CMD/PowerShell（环境变量不会热加载）
- Linux/macOS 手动解压安装后，漏配 export PATH=$PATH:/usr/local/go/bin 或没执行 source ~/.zshrc
- 安装路径含空格（如 C:\Program Files\Go），某些旧 shell 会解析失败——建议重装到 C:\Go 或 /opt/go
go env 显示 GOROOT 路径错误
go env GOROOT 输出的路径必须指向真实安装目录，比如 /usr/local/go 或 C:\Go。若显示为空、~/go 或明显错误路径（如 /home/user/go），说明 GOROOT 被误设或未设，会导致后续 fmt 等标准库找不到。
修复方式：
- Windows：用 go env -w GOROOT="C:\Go"（注意路径用双引号包裹）
- Linux/macOS：在 shell 配置文件中加 export GOROOT=/usr/local/go，再 source
- 切勿把 GOROOT 指向 GOPATH 或项目目录——这是新手高频错误
go run main.go 报 cannot find package "fmt"
这个错误不是代码问题，而是 Go 运行时无法定位标准库，90% 源于 GOROOT 错或损坏。
排查步骤：
- 先确认 GOROOT 是否正确（见上一条）
- 进入 $GOROOT/src/fmt 目录，看是否存在 fmt.go 文件
- 检查当前目录是否有同名 go.mod 干扰（比如文件名是 fmt.go，会触发模块解析冲突）
- 文件编码是否含 BOM（尤其 Windows 记事本保存的 UTF-8），改用 VS Code 或 vim 保存为 UTF-8 without BOM
go mod init 后 go list -m 无输出或报错
现代 Go 项目依赖模块机制，go mod init 成功但 go list -m 不返回模块名，说明模块系统未激活或配置异常。
关键检查项：
- go env GO111MODULE 必须是 on，不是 auto 或空
- 当前目录不能在 $GOPATH/src 下（否则会降级为 GOPATH 模式）
- 若用国内代理，go env GOPROXY 应含 https://goproxy.cn，否则 go mod download 会卡住
- go mod init example.com/test 生成的 go.mod 第一行必须是 module example.com/test，不能是本地路径或空字符串
真正卡住的地方往往不在第一步——go version 成功只是起点，go run 能跑通也不代表模块可用。最容易被忽略的是 GO111MODULE=on 和 GOPROXY 这两个开关，它们决定你接下来半小时是在写代码，还是在查超时错误。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
