go version报错说明path未配置，需将$goroot/bin加入path；goroot为空或路径错误需修正；cannot find package "fmt"表明goroot/src损坏；go mod init失败常因go111module=auto且目录在gopath/src下。
go version 命令报错说明 PATH 没配对
直接输 go version 是第一道门槛。输出类似 go version go1.22.5 darwin/arm64 就过了；如果报 command not found（macOS/Linux）或 'go' is not recognized（Windows），不是没装，而是 PATH 漏掉了 $GOROOT/bin（Linux/macOS）或 %GOROOT%\bin（Windows）。
常见漏点：
• Windows 手动解压安装后没加环境变量
• macOS/Linux 修改了 ~/.zshrc 但没执行 source ~/.zshrc
• Windows MSI 安装时没勾选 “Add Go to PATH”
go env 显示 GOROOT 为空或路径奇怪就是根目录错了
go env GOROOT 必须指向 Go 的安装根目录，比如 /usr/local/go（macOS/Linux）或 C:\Go（Windows）。如果返回空、/home/you/project 这种项目路径，或者根本不存在的路径，说明 GOROOT 被误设或压根没设。
注意：
• GOROOT 不是你放项目的目录，也不该是 $HOME/go
• 大多数情况下不用手动设 GOROOT，官方安装包会自动处理；手动解压才需要检查
• go env GOPATH 可以为空——Go 1.16+ 默认启用模块，GOPATH 只影响 go install 输出位置
go run main.go 报 cannot find package "fmt" 是 GOROOT/src 损坏
能跑 go version、go env 正常，但 go run main.go 却提示 cannot find package "fmt" 或 build failed: cannot load fmt，大概率是 GOROOT/src 目录缺失或权限异常。
验证方法：
• 进入 $GOROOT 目录，确认存在 src 子目录
• ls $GOROOT/src/fmt（macOS/Linux）或 dir %GOROOT%\src\fmt（Windows）应列出标准库文件
• 别用编辑器保存带 BOM 的 UTF-8 文件，也别在路径含中文或空格的目录下测试
go mod init 失败往往因为当前目录在 GOPATH/src 下且 GO111MODULE=auto
现代 Go 项目依赖模块机制，go mod init example.com/hello 应生成 go.mod 并输出模块名。失败常见于：
• 当前路径在 $GOPATH/src 下，且 GO111MODULE 是 auto（默认值），此时 Go 会降级为 GOPATH 模式，go mod init 静默不生成文件
• 解决：先运行 go env -w GO111MODULE=on 强制启用模块
• 或换到任意非 $GOPATH/src 的干净目录再试
• 注意：go list -m 成功输出模块名才算模块系统真正就位
go 能跑、go run 能输出、go mod init 看似成功，但后续 go get 或构建第三方包时突然卡住——那往往是网络代理或模块镜像配置被忽略。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
