Go环境配置三大关键：安装路径勿乱改、必须设置代理、go env -w手动配置；Windows需验证PATH是否含C:\Go\bin，Linux/macOS须将$GOROOT/bin加入PATH并source生效；国内需设GOPROXY=https://goproxy.cn,direct；go mod init后须在go.mod所在目录执行go run。
Go 环境装不上、go version 报错、go run 找不到包、国内 go get 卡死——这些问题不是你手残，而是默认配置没调对。装 Go 不是点下一步就完事，关键在三个地方：安装路径别乱改、代理必须换、go env -w 要动手设。
Windows 上 MSI 安装后 go version 无效？检查 PATH 是否真生效
MSI 安装器理论上会自动加 C:\Go\bin 到系统 PATH，但实测 Windows 10/11 常因权限或缓存问题漏加。别信“安装完就可用”，务必手动验证：
- 打开**全新**的 CMD 或 PowerShell（旧窗口不继承新环境变量）
- 执行
echo %PATH%，搜C:\Go\bin—— 没出现就是没加进去 - 手动添加：系统属性 → 高级 → 环境变量 → 系统变量 → Path → 新建 → 填
C:\Go\bin - 再开一个新终端，
go version必须能打出版本号才算过关
Linux/macOS 解压后 go 命令找不到？$GOROOT/bin 必须进 $PATH
Linux/macOS 不像 Windows 有图形化安装器，解压只是放文件，PATH 完全靠自己配。常见错误是只加了 /usr/local/go/bin，却忘了 source 配置文件：
- 确认
GOROOT是你解压的路径，比如/usr/local/go - 在
~/.zshrc（macOS Sonoma+ 默认）或~/.bashrc末尾加两行：export GOROOT=/usr/local/goexport PATH=$PATH:$GOROOT/bin - 执行
source ~/.zshrc（别漏这步！） - 用
which go验证是否指向$GOROOT/bin/go
国内 go get 卡住或超时？立刻换 GOPROXY
Go 1.13+ 默认用 https://proxy.golang.org，国内直连基本失败。这不是网络问题，是代理没切。别试科学上网，直接换国内镜像：
立即学习“go语言免费学习笔记（深入）”；
- 运行命令：
go env -w GOPROXY=https://goproxy.cn,direct - 验证：
go env GOPROXY应输出https://goproxy.cn,direct - 注意
direct不能删——它保证私有仓库（如公司内网 Git）仍能直连 - 如果公司用自建 Nexus/Artifactory，把
https://goproxy.cn换成你的地址即可
go mod init 后 go run 报 “no required module”？模块根目录和 go.mod 必须对齐
Go Modules 不依赖 GOROOT 或 GOPATH，但极度依赖当前工作目录是否在模块根下。典型症状是：go mod init myapp 成功，但 go run main.go 报错说找不到包。
- 确保你在
main.go所在目录执行命令，且该目录下有go.mod - 用
pwd（Linux/macOS）或cd（Windows）确认当前路径 - 如果
go.mod在子目录，cd 进去再跑go run；别在父目录硬试 - 新手常误把项目建在
%USERPROFILE%\go\src\下还启 Modules——现在完全不需要这个结构
最易被忽略的一点：所有 go env -w 设置只对当前用户生效，且不会自动同步到 IDE。VS Code 的 Go 插件、GoLand 都要单独重启或重载环境，否则它们还在用旧的 GOPROXY 或 GOROOT。装完别急着写代码，先关掉编辑器再重开一次。
