go version报错说明go未进入PATH，需检查where go是否返回路径、确认GOROOT\bin已加入PATH；GOPATH可用go env -w修改；go mod init需指定模块名；文件编码须为UTF-8无BOM。
go version 命令报错或无输出
说明 go 命令根本没进系统 PATH，不是安装失败，而是路径没生效。Windows 上常见于安装时勾选了「Add Go to PATH」但未重启终端，或手动配置 Path 时路径写错（比如漏了 \bin）。
检查方法：在 CMD 或 PowerShell 中运行 where go（Windows）或 which go（macOS/Linux）。如果返回空，就说明没找到。
- Windows 用户确认安装路径（默认是
C:\Program Files\Go或C:\Go），然后把%GOROOT%\bin加进系统环境变量 Path（注意：%GOROOT%要设为 Go 安装目录，如C:\Go） - macOS/Linux 用户检查
~/.zshrc或~/.bash_profile是否写了export PATH=$PATH:/usr/local/go/bin，并执行source ~/.zshrc - 别用
go env GOROOT反推路径——它可能显示空或错误值，因为go都没跑起来
go env 显示 GOPATH 仍是默认值，但想改到 D 盘
新版 Go（1.16+）默认启用 modules，GOPATH 不再影响依赖存放位置，只影响 go install 生成的可执行文件落点（即 $GOPATH/bin）。所以改它主要是为了统一工具链路径，不是必须项。
改法很简单，用 go env -w 写入（比手动改环境变量更可靠，且跨 shell 生效）：
立即学习“go语言免费学习笔记（深入）”；
go env -w GOPATH=D:\go_workspace
之后所有新终端都会读取这个值。注意：D:\go_workspace 下会自动建 bin、pkg、src 三级目录，但你几乎不会直接往 src 里放代码——模块模式下，项目可放在任意路径。
go mod init 报错 “cannot determine module path for source directory”
这是刚初始化项目时最常卡住的地方。根本原因：当前目录不在 GOPATH 下，又没指定模块名，Go 不知道该给这个项目起什么“全限定名”。
解决方式只有两种，任选其一：
- 明确指定模块路径：比如项目在
D:\myproj，运行go mod init example.com/myproj（名字不用真实存在，只是逻辑标识） - 或者干脆用域名占位：
go mod init myapp——合法，但不推荐用于将来要发布到公共仓库的项目
别试图靠把项目挪到 %GOPATH%\src 下绕过这个问题。那套老式 src/pkg/bin 结构在模块时代已弃用，硬用反而导致 go get 行为异常。
go run hello.go 提示 “package main is not in GOROOT”
典型症状：文件内容没错，路径也没空格，但就是报这个错。真正原因是：文件名不是 .go 后缀，或者编辑器悄悄存成了 UTF-8 with BOM 编码（尤其 Windows 记事本）。
验证和修复步骤：
- 用
file hello.go（macOS/Linux）或Get-Content hello.go -Encoding Byte（PowerShell）看头几个字节有没有 EF BB BF - 用 VS Code、Notepad++ 或
vim重存为 UTF-8 无 BOM 格式 - 确保文件名确实是
hello.go，而不是hello.go.txt（Windows 默认隐藏扩展名）
模块初始化不是必须前置条件——单文件 go run 不依赖 go.mod，只要语法正确、编码干净就能跑通。
真正容易被忽略的是：Go 的模块缓存（GOMODCACHE）默认落在用户目录下，首次 go get 可能很慢，且磁盘空间占用不小。如果 C 盘紧张，建议早一步用 go env -w GOMODCACHE=E:\go\modcache 指定位置，避免后期清理麻烦。
