go version报错最常见原因是path未正确配置：windows需重启终端使msi安装的path生效，macos/linux需手动将/usr/local/go/bin或$goroot/bin加入path并source配置文件，zip安装必须手动添加路径。
go version 命令报错或找不到，PATH 没配对
最常见的情况是安装完 Go 后，go version 报 'go' is not recognized as an internal or external command（Windows）或 command not found: go（macOS/Linux）。这不是 Go 没装好，而是 PATH 没生效。
MSI 安装包（Windows）默认会写入系统 PATH，但必须重启终端——关掉所有 CMD/PowerShell 窗口再重新打开；ZIP 包则完全不会动环境变量，得手动加 C:\Program Files\Go\bin 或 /usr/local/go/bin 到 PATH。
- 验证方式：执行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认路径里真有go所在的bin目录 - 别把
GOROOT加进 PATH——只要加%GOROOT%\bin或$GOROOT/bin就够了 - 如果用 zsh/bash，改完
~/.zshrc后记得source ~/.zshrc，否则不生效
go mod init 失败：GO111MODULE=off 或当前目录含空格/中文
go mod init 报 go: modules disabled by GO111MODULE=off，说明模块系统被关了。Go 1.16+ 默认开启，但旧 shell 或某些 IDE 可能继承了历史配置。
直接运行 go env -w GO111MODULE=on 永久启用；临时启用可加 -mod=mod 参数，比如 go build -mod=mod。
- 项目路径不能含空格或中文——
D:\my project\hello或/Users/张三/code都会导致go mod init解析失败，改用纯英文路径 - 别在
$GOPATH/src下初始化模块——Go Modules 和 GOPATH 是互斥的，混用会触发警告甚至构建异常 - 模块名建议用域名格式，如
go mod init example.com/hello，避免后续导入路径出错
GOPROXY 设置后仍拉包超时：direct 回源没生效或 GOSUMDB 干扰
设了 https://goproxy.cn 还卡在 Fetching github.com/xxx，大概率是 GOSUMDB 在校验阶段阻塞。国内镜像不提供 sumdb 服务，必须关掉或换用兼容地址。
执行这三条命令一次到位：
go env -w GO111MODULE=on go env -w GOPROXY=https://goproxy.cn,direct go env -w GOSUMDB=off
-
direct的作用是：代理查不到包时，自动 fallback 到官方源（proxy.golang.org），不是“跳过代理”，所以必须保留逗号分隔 - 别用
https://mirrors.aliyun.com/goproxy/——该地址已停服，返回 404，会导致整个依赖流程中断 - 验证是否生效：
go env GOPROXY应输出https://goproxy.cn,direct，不是https://goproxy.cn单独一个
VS Code 里代码没提示、跳转失效：gopls 没装或权限被拦截
VS Code 装了 Go 扩展，但 fmt.Println 不高亮、Ctrl+Click 跳不到定义，通常是 gopls（Go language server）没装或启动失败。
首次打开 .go 文件时，编辑器会弹窗问“Install All Tools”，点它；如果错过，手动运行：
go install golang.org/x/tools/gopls@latest
- Windows 上若报
permission denied，说明go install写入的是%USERPROFILE%\go\bin，而 VS Code 没读到这个路径——把该路径加进系统 PATH - macOS/Linux 如果用了
sudo go install，生成的二进制属主是 root，gopls会因权限问题拒绝启动，务必去掉sudo - 检查状态：Cmd+Shift+P → “Go: Show Output”，选 “gopls (server)” 查看日志，常见错误如
no module found表示没在模块根目录打开项目
GOSUMDB=off 和 direct 的组合——少了任一环节，都可能让 go get 卡死在证书校验或 sum 校验上，而不是网络超时。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
