go version报错因path未生效，需检查并修改系统path；gopath可改但goroot勿动；国内需设goproxy=https://goproxy.cn,direct；vs code需重启并手动安装gopls。
go version 命令报错或不识别，说明 PATH 没生效
安装完 Go 后运行 go version 提示“不是内部或外部命令”，基本就是 PATH 没配对。Windows 上 MSI 安装器默认会加 C:\Program Files\Go\bin 到系统 PATH，但某些旧版 Windows 或手动安装时可能漏掉。
- 检查是否真没加：打开 CMD，执行
echo %PATH%，搜Go\bin；没找到就手动补 - 别只改用户 PATH——必须改“系统变量”里的 PATH，否则新终端不继承
- 改完别忘了重启终端（CMD/PowerShell/VS Code 终端全关重开），
PATH不是热加载的 - macOS/Linux 用户如果用
.zshrc配了export PATH=$PATH:/usr/local/go/bin，记得执行source ~/.zshrc，否则当前 shell 仍无效
go env 显示 GOPATH 是 C:\Users\XXX\go，但我想放 D:\mygo
Go 1.11+ 默认启用 Go Modules，GOPATH 对日常开发已非必需，但某些老工具或私有包拉取仍会读它。你可以安全修改，但要注意：
- Windows 下用命令改：
go env -w GOPATH=D:\mygo（注意路径用反斜杠或正斜杠都行，但别混用） - 改完立刻生效，不用重启终端；但已打开的 IDE（如 VS Code）可能缓存旧值，建议重启窗口
- 别把
GOPATH和GOROOT搞混：GOROOT是 Go 安装目录（如C:\Program Files\Go），绝对不要手动改它 - 如果你只用 Go Modules（推荐），其实可以完全不管
GOPATH，go mod init创建的项目不依赖它
go get 总超时或失败，国内访问 proxy.golang.org 被拦
这是最常卡住新手的点。默认代理 https://proxy.golang.org 在国内无法直连，go get 或 go mod download 就会卡死或报错 timeout、no such host。
- 设国内镜像代理最快：执行
go env -w GOPROXY=https://goproxy.cn,direct - 多个镜像可备选：
https://goproxy.io或https://mirrors.aliyun.com/goproxy/，但goproxy.cn稳定性目前最好 -
direct表示对私有模块（比如公司内网 git 地址）绕过代理，这个后缀不能省 - 验证是否生效：运行
go env GOPROXY，输出应为刚设的地址，不是空或https://proxy.golang.org
VS Code 里 go extension 提示 “The Go binaries are missing”
这不是 Go 没装好，而是 VS Code 的 Go 插件没找到 go、gopls 这些二进制工具。常见于：
- Go 安装后没重启 VS Code —— 插件启动时读的是旧环境变量，PATH 变了它不知道
- 你用的是便携版 VS Code 或通过快捷方式启动，它可能没继承系统 PATH（尤其 Windows）
-
gopls没自动装：插件默认会尝试下载，但被墙后失败，日志里能看到failed to install gopls - 解决方法：在 VS Code 终端里手动运行
go install golang.org/x/tools/gopls@latest，装完再 Ctrl+Shift+P → “Go: Install/Update Tools” 全勾选重装一遍
GOPROXY 和 gopls 这两个点——前者让 go mod 能跑起来，后者让编辑器有代码跳转和提示。没它们，Go 环境就算装上了，也基本没法写。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
