Go环境搭建失败主因是PATH未生效或代理未配置：go version报错需检查PATH是否含go/bin；GOPROXY须设为https://goproxy.cn,direct；GO111MODULE=on必须启用；VS Code需手动安装gopls。
Go 环境装不起来，八成卡在环境变量或代理上，不是你手慢，是默认配置没覆盖真实网络和路径场景。
go version 无效？先确认 PATH 里真有 go
很多人输 go version 报错 “command not found”，第一反应是“安装失败”，其实更可能是 PATH 没生效。
- Windows：安装 .msi 时勾选了“Add Go to PATH”才自动加；若没勾，得手动把
C:\Go\bin（或你选的安装路径下的\bin）加进系统 PATH - macOS/Linux：
/usr/local/go/bin不一定在 PATH 里，尤其用.tar.gz手动解压的用户，必须自己export PATH=$PATH:/usr/local/go/bin并source ~/.zshrc（macOS Sequoia 默认 zsh） - 验证方式不是只跑一次命令，而是新开一个终端再试——旧终端不会自动继承新 PATH
GOPATH 和 GO111MODULE 到底要不要设？
Go 1.16+ 默认开启 module 模式，GOPATH 已退居二线，但某些老教程或 IDE 插件仍会读它，容易引发路径混乱。
-
GO111MODULE=on是必须的，否则go mod init会报 “unknown import path” -
GOPATH可以不设——现代项目靠go.mod管理依赖，$HOME/go（Linux/macOS）或C:\Users\用户名\go（Windows）只是工具缓存目录，不影响编译 - VS Code 的 Go 扩展如果提示 “cannot find GOPATH”，其实是它在找
gopls或dlv的安装位置，不是真要你设 GOPATH；直接点底部状态栏 “Install All Tools” 更可靠
go mod download 总超时？换国内代理是刚需
不用代理时，go mod download 卡住、超时、404，不是网差，是 golang.org 域名被阻断或延迟高。
立即学习“go语言免费学习笔记（深入）”；
- 执行这句就能切到国内镜像：
go env -w GOPROXY=https://goproxy.cn,direct - 别只信“goproxy.io”，它已停服；
https://mirrors.aliyun.com/goproxy/和https://goproxy.cn目前稳定 - 如果公司内网禁外网，可设
direct在最后兜底，避免私有模块拉不到 - 验证是否生效：
go env GOPROXY输出应含你刚设的地址
VS Code 装完 Go 扩展却没代码提示？重点查 gopls
VS Code 装了 Go 插件但没语法高亮、跳转、补全，大概率是 gopls（Go language server）没装或版本不匹配。
- 不要等它自动弹窗提示“Installing tools”——有时静默失败，直接按
Ctrl+Shift+P→ 输入 “Go: Install/Update Tools”，全选安装 - 如果卡在
gopls，手动运行：go install golang.org/x/tools/gopls@latest - 装完后重启 VS Code，打开
main.go，看左下角是否显示 “gopls (running)” ——不是 “loading” 或空白 - 若仍不行，检查
go env GOMOD是否指向当前项目根目录下的go.mod；没生成就先go mod init example.com/hello
真正卡住人的从来不是“装不上”，而是装上了但某个环节没回显、没报错、没日志——比如代理没生效却只提示 timeout，gopls 没启动却只显示空白状态栏。盯住 go env 输出、新开终端、手动触发工具安装，比重装三遍更省时间。
