Go环境能跑起来的关键是go命令可在任意目录执行且go mod能正常拉包；需正确配置PATH、GOROOT、GOPROXY（含,direct）及IDE中GOROOT无尾斜杠。
Go 环境能跑起来，关键不是装没装，而是 go 命令能不能在任意目录下执行，以及 go mod 能不能正常拉包——这两点卡住，90% 的新手会以为“安装失败”，其实只是路径或代理没配对。
go 命令找不到？先查 PATH 和 GOROOT
输入 go version 报错 command not found 或 'go' is not recognized，说明系统根本没把 Go 的二进制目录加进 PATH。
- Windows 用户：检查
%GOROOT%\bin（比如C:\Program Files\Go\bin）是否在系统环境变量Path里；别只看用户变量，得看“系统变量”里的Path - macOS/Linux 用户：运行
echo $PATH，确认输出里包含/usr/local/go/bin或你解压 Go 的实际路径下的bin目录 - 不管哪个平台，都该用
go env GOROOT看 Go 安装根目录是否被正确识别；如果为空或错误，手动设GOROOT并重载 shell 配置（source ~/.zshrc或source ~/.bashrc）
GOPATH 还要不要设？现代项目基本不用管它
Go 1.16+ 默认启用模块模式（GO111MODULE=on），GOPATH 不再决定项目存放位置，只影响三类东西：go install 生成的可执行文件、go get 下载的工具（如 gopls）、依赖缓存。所以：
- 不必为每个新项目创建
$GOPATH/src/xxx目录结构；项目可建在桌面、~/projects任意位置 -
GOPATH默认是$HOME/go，除非你要把工具二进制统一放到别的地方（比如/opt/go-tools），否则无需修改 - 执行
go env GOPATH看值就行，只要不报错、路径可写，就不用动它
go mod download 总超时？代理必须配，且顺序不能错
国内直接连 proxy.golang.org 几乎必失败，但光改 GOPROXY 还不够——漏掉 direct 就会导致私有模块无法回退。
立即学习“go语言免费学习笔记（深入）”；
- 推荐命令（任选其一）：
go env -w GOPROXY=https://goproxy.cn,direct或go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct - 注意逗号后必须跟
direct，这是 fallback 机制：公共包走代理，私有域名（如git.internal.company.com）自动绕过代理直连 - 验证是否生效：新建空目录，
go mod init example.com/test，再go get rsc.io/quote；成功则说明代理和网络通路都 ok
IDE 里提示 “Cannot resolve Go SDK”？别急着重装，先看 GOROOT 路径格式
VS Code、GoLand、IntelliJ 插件报这个错，80% 是因为 IDE 读到的 GOROOT 路径末尾带了斜杠（比如 /usr/local/go/），而 Go 工具链内部校验要求无尾斜杠。
- VS Code：打开设置 → 搜索
go.goroot，填入/usr/local/go（Linux/macOS）或C:\Go（Windows），**不要加\或/结尾** - GoLand：Settings → Languages & Frameworks → Go → GOROOT，点击文件夹图标选择路径，选中后自动去除尾斜杠；若手动输入，务必删掉末尾斜杠
- 验证方式：在 IDE 终端里执行
go env GOROOT，输出应与 IDE 配置一致且无尾斜杠
最常被忽略的是代理配置里的 ,direct 和 IDE 中 GOROOT 的尾斜杠——这两个小细节不处理，环境看似装好了，实际写代码时依赖拉不下来、调试器起不来，问题会分散在不同环节，排查成本远高于一开始花 30 秒配对。
