go version报错是Path未配置，需手动添加%GOROOT%\bin；go mod init超时因代理不可达，应执行go env -w GOPROXY=https://goproxy.cn,direct；VSCode提示找不到go二进制需在设置中配置go.goroot并重启。
go version 验证失败但安装明明完成了
常见现象是双击 .msi 安装完，go version 报“不是内部或外部命令”。这不是安装失败，而是 Windows 没把 go 的 bin 目录加进 Path 环境变量。
- 打开“系统属性 → 高级 → 环境变量”，在“系统变量”里找到
Path，点击“编辑” - 添加一行：
%GOROOT%\bin（如果没手动设GOROOT，就直接填绝对路径，比如C:\Go\bin） - 新开一个 CMD 或 PowerShell 再试 —— 不要复用旧窗口，它不会自动读取新环境变量
go mod init 时提示 “unknown revision” 或超时
这是国内直连 proxy.golang.org 失败的典型表现，尤其在首次拉依赖或初始化模块时。Go 1.13+ 默认启用模块代理，但默认地址在国内不可达。
- 运行
go env -w GOPROXY=https://goproxy.cn,direct（推荐 CN 镜像，稳定且支持私有包 fallback） - 如需兼容企业内网私有仓库，改成
go env -w GOPROXY=https://goproxy.cn,https://your-internal-proxy.com,direct - 顺手关掉
GO111MODULE自动判断风险：go env -w GO111MODULE=on，避免某些旧项目目录下意外退回到 GOPATH 模式
VSCode 中 Go 插件反复提示 “Failed to find ‘go’ binary”
VSCode 的 Go 扩展（vscode-go）不读系统全局 Path，而是依赖它自己解析的 GOROOT 和 PATH。即使终端能跑 go，编辑器里也可能报错。
- 在 VSCode 设置里搜
go.goroot，填入你实际的 Go 安装路径，例如C:\Go（Windows）或/usr/local/go（macOS/Linux） - 确认插件没被禁用：按
Cmd/Ctrl+Shift+P→ 输入Go: Install/Update Tools，全选并安装（会拉dlv、gopls等） - 重启 VSCode —— 单纯重载窗口不够，必须彻底关闭再打开，否则
gopls进程可能卡在旧配置里
想换 GOPATH 但 go env 显示还是 ~/go
新版 Go（1.16+）默认不再强制使用 GOPATH，但 go env 仍会显示一个默认值。这个值只影响 go install 输出位置和部分旧工具行为，不影响模块项目。
立即学习“go语言免费学习笔记（深入）”；
- 如果你真需要改（比如统一团队 workspace 路径），执行
go env -w GOPATH=D:\mygo（Windows）或go env -w GOPATH=$HOME/go-workspace（macOS/Linux） - 改完后
go env GOPATH会立刻生效，但注意：新建模块项目（go mod init）完全不依赖它；只有go get到非模块包、或用go install时才写入该路径下的bin - 绝大多数现代项目可以忽略
GOPATH，重点盯住go.mod和GOPROXY就够了
GOPROXY）和语言服务器（gopls）的版本匹配问题。比如 gopls v0.14 要求 Go 1.21+，但你装了 Go 1.20 还硬升级插件，就会卡在“Loading…”。遇到这类问题，先看 gopls 日志（VSCode 底部状态栏点“Go” → “Show Logs”），再决定是降插件还是升 Go。 
