go version报错说明path未包含$goroot/bin；go env gopath为空影响go install；go get失败多因goproxy未配置；vs code无提示常因gopls未装或path缺失。
go version 命令报错或找不到，说明 PATH 没配对
安装完 Go 后，go version 报 command not found 或 'go' is not recognized，90% 是因为 PATH 里没包含 $GOROOT/bin（Windows 是 %GOROOT%\bin）。
不同系统处理方式不同：
• Windows 安装 .msi 包时，如果选了“Add to PATH”，通常自动生效；但必须关掉所有 CMD/PowerShell 窗口再重开，否则环境变量不刷新
• Linux/macOS 解压后，要手动把 /usr/local/go/bin（或你解压的路径）追加到 shell 配置文件（如 ~/.zshrc）的 PATH 里，然后执行 source ~/.zshrc
• 不要只写 export PATH=/usr/local/go/bin —— 这会覆盖原有 PATH，正确写法是 export PATH=$PATH:/usr/local/go/bin
go env 显示 GOPATH 为空或不对，影响 go install 工具
go install 下载的工具（比如 gopls、dlv）默认放进 $GOPATH/bin，如果这个目录不在 PATH 里，就无法在终端任意位置调用。
检查方法：go env GOPATH，输出应为一个实际存在的路径（如 /home/username/go 或 C:\Users\name\go）
常见问题：
• 新版 Go（1.16+）虽默认启用模块，但 go install 仍依赖 GOPATH 存放二进制
• 如果没显式设置 GOPATH，Go 会用默认值（$HOME/go），但该目录可能不存在，需手动创建：mkdir -p $HOME/go/bin
• 确保 $GOPATH/bin 也加入 PATH，否则 gopls 等工具装了也用不了
go get 或 go mod download 失败，核心是 GOPROXY 没设好
国内用户不配代理，go mod download 几乎必卡在 golang.org/x/... 或第三方包上，错误常是 timeout 或 no such host。
必须执行这三行（Windows PowerShell / Linux/macOS 终端均适用）：go env -w GO111MODULE=ongo env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=off（或 sum.golang.org，但国内建议先关掉校验避免干扰）
验证是否生效：go env GOPROXY 应输出 https://goproxy.cn,direct
注意：direct 表示当代理找不到包时，回源官方地址，不是“直连”，别删掉
VS Code 里代码没提示、跳转失效，大概率是 gopls 没装或路径不对
VS Code 的 Go 扩展依赖 gopls（Go language server）提供智能提示、格式化、跳转等功能。装了扩展但没反应，八成是 gopls 没装或不在 PATH。
正确做法：
• 先确保 GOPATH/bin 在 PATH 中（见第二点）
• 运行 go install golang.org/x/tools/gopls@latest（不是 go get，新版已弃用）
• VS Code 设置里搜索 “go.goplsPath”，确认值为空（让它自动找）或指向你本地的 gopls 可执行文件路径
• 如果项目用了 Go Modules，根目录必须有 go.mod 文件，否则 gopls 不会激活
GOPROXY 和 PATH 是两个最易出错又最影响体验的点，其他步骤出错往往只是延迟，而这俩一错，整个开发流程就卡住。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
