Go环境配置失败主因是下载源、环境变量顺序及GO111MODULE状态；需用golang.google.cn下载安装包，GOPROXY设为goproxy.cn,direct；go env -w优先级高于shell配置但不改PATH；PATH须包含$GOROOT/bin且避免重复；Windows需确保系统PATH含%GOROOT%\bin。
Go 环境能装好，但卡在 go version 报错或模块拉不下来？问题大概率出在下载源、环境变量顺序、或 GO111MODULE 状态上——不是版本新就一定稳，也不是装完就自动可用。
怎么选下载源才不被墙住
国内直接访问 https://go.dev/dl/ 常失败，proxy.golang.org 也基本不可用。必须换镜像源，且要分两层处理：
- 安装包下载：用官方镜像站
https://golang.google.cn/dl/（稳定、同步快），别信第三方打包站 - 模块代理（
GOPROXY）：推荐https://goproxy.cn或https://mirrors.aliyun.com/goproxy/，二者都支持direct回退 - 别用已停服的
goproxy.io（2025 年底已下线），也别只设https://goproxy.cn不加,direct，否则私有模块会失败
go env -w 和手动改 shell 配置哪个优先级高
go env -w 写入的是 Go 自己的配置文件（$HOME/go/env），优先级高于 shell 的 export。但有个坑：它不覆盖 PATH，只管 Go 工具链内部行为。
- PATH 必须靠 shell 配置（如
~/.zshrc）：确保/usr/local/go/bin或你自定义的$GOROOT/bin在最前面 -
go env -w GOPROXY=...可以生效，但go env -w GOROOT=...会被忽略——GOROOT只认安装路径或显式export - 执行
go env后检查GOPROXY和GO111MODULE是否为on，不是就补：go env -w GO111MODULE=on
Linux/macOS 下解压安装后 PATH 没生效的常见原因
解压安装（tar -C /usr/local -xzf go*.tar.gz）后，go version 找不到命令，90% 是 PATH 没刷进当前 shell。
立即学习“go语言免费学习笔记（深入）”；
- 确认改的是当前 shell 的配置文件：
zsh用户改~/.zshrc，bash用户改~/.bashrc，别混用 -
source ~/.zshrc后，再新开一个终端验证——旧终端不会自动 reload - 别漏掉
$GOROOT/bin：只加$GOPATH/bin不够，go命令本身就在$GOROOT/bin里 - 检查是否重复添加：
echo $PATH | tr ':' '\n' | grep go，避免多个go/bin路径冲突
Windows MSI 安装后仍提示“go 不是内部或外部命令”
MSI 安装默认勾选 “Add Go to PATH”，但有时会失效，尤其在非管理员账户、或系统 PATH 超长时。
- 打开 PowerShell，运行
$env:Path -split ';' | Select-String go，看有没有C:\Go\bin或你自定义的路径 - 如果没出现，手动编辑系统环境变量：新增
GOROOT（值为C:\Go），再把%GOROOT%\bin加到Path开头 - 别用“用户变量”单独加 PATH——系统变量里的 PATH 会覆盖用户变量，必须改系统变量或确保用户变量排在前面
- 重启终端（不是关窗口，是彻底退出再开），再试
go version
真正麻烦的从来不是装不装得上，而是装完后 go mod download 卡住、go run 报 cannot find module、或者 go env 显示的 GOPROXY 和你设的不一致——这些全是环境变量叠加和优先级惹的祸，盯住 go env 输出，比反复重装有用得多。
