go version报错说明PATH未配置或安装失败；Windows需确认MSI勾选“Add Go to PATH”并重启终端，Linux/macOS须手动将go/bin加入shell配置；可用where go或which go验证路径。
go version 命令报错或不识别
说明系统根本没把 go 加进 PATH，或者安装压根没成功。Windows 上 .msi 安装器默认会自动加 PATH，但如果你勾选了“Add to PATH manually”或用了自定义路径，就得自己补；Linux/macOS 解压后必须手动把 /usr/local/go/bin（或你解压的实际路径）加到 shell 配置文件里。
- 检查
go是否在 PATH 中：运行which go（Linux/macOS）或where go（Windows CMD） - 如果返回空，就去改配置文件：
~/.zshrc或~/.bashrc末尾追加export PATH=$PATH:/usr/local/go/bin，然后source ~/.zshrc - Windows 用户别只改用户环境变量，要确认“系统变量”里的
Path也包含了C:\Go\bin - 重启终端——不是关窗口再开，是彻底新建一个终端进程，否则旧 shell 不读新 PATH
go mod init 失败提示 “cannot determine module path”
这是新手最常卡住的地方：当前目录不在 GOPATH 下，又没指定模块名，go mod init 就不知道该用什么路径当模块根。它不是 bug，是 Go 的显式命名要求。
- 必须带参数运行：
go mod init example.com/myapp，域名部分可以是假的，但不能省略 - 别用中文路径、空格路径、桌面路径——Windows 用户尤其注意，
C:\Users\张三\Desktop\test这种路径大概率触发编码或权限问题，换到D:\go-projects\test这类纯英文路径 - 如果项目已有
go.mod文件但内容异常，直接删掉再跑go mod init，别试图手动编辑 - 执行后检查是否生成了
go.mod和go.sum，前者第一行必须是module example.com/myapp
VS Code 提示 “gopls not installed” 或代码无提示
VS Code 的 Go 扩展依赖 gopls（Go Language Server）提供智能提示，但它不会随插件自动装好，尤其是国内网络环境下容易卡在下载环节。
- 先确认已安装官方 Go 插件（Publisher 是 “Go Team at Google”），不是第三方山寨版
- 打开任意
.go文件，底部状态栏点 “Install All Tools”，等弹窗出现后，**不要直接点 Install**——先点右上角齿轮图标，选 “Change Tools Directory”，设为$GOPATH/bin（Windows 是%GOPATH%\bin） - 如果卡住，手动安装：
go install golang.org/x/tools/gopls@latest，若超时，先设代理：go env -w GOPROXY=https://goproxy.cn,direct - 装完重启 VS Code，再按
Ctrl+Shift+P输入 “Go: Restart Language Server”，别信右下角的小弹窗，它经常不刷新状态
go run main.go 报错 “package main is not in GOROOT”
这错误听起来像 Go 安装坏了，其实八成是文件没放对位置——Go 要求可执行文件必须在 package main 的包里，且该目录下不能有其他 package xxx 的同级文件干扰。
立即学习“go语言免费学习笔记（深入）”；
- 确保
main.go文件开头是package main，不是package mylib或其他 - 删掉当前目录下所有非
.go文件（比如README.md、node_modules）和非 main 包的.go文件，go run对混杂文件很敏感 - 别在
$GOROOT/src或$GOPATH/src里直接写代码——那是 Go 自身源码和旧式 GOPATH 项目的位置，现代项目应放在任意独立目录 - 如果用了 IDE，确认它没偷偷帮你开了 GOPATH 模式（IntelliJ IDEA 默认可能启用），关掉：Settings → Languages & Frameworks → Go → 取消勾选 “Enable GOPATH mode”
go env 输出里的 GOROOT、GOPATH、GOPROXY 三项，再看当前目录是不是干净、有没有中文、有没有被杀毒软件盯上——比反复重装 Go 有效得多。 
