go环境配置失败主因是环境变量或代理设置错误，而非下载问题；需检查path是否包含go路径、启用go111module、配置goproxy为https://goproxy.cn,direct，并确保在项目根目录操作。
Go 环境装不起来，八成卡在环境变量或代理配置上，而不是下载失败。
go version 命令报 command not found
这是 PATH 没生效的典型表现，尤其常见于 Linux/macOS 的 shell 配置文件未被正确加载，或 Windows 安装时勾选了“Add to PATH”但没重启终端。
- Linux/macOS：检查
~/.bashrc、~/.zshrc或/etc/profile是否包含类似export PATH=$PATH:/usr/local/go/bin；改完后执行source ~/.zshrc（或对应 shell 文件） - Windows：确认安装时是否勾选 “Add Go to PATH”，若没勾选，手动把
C:\Program Files\Go\bin加入系统环境变量 PATH；改完必须重启命令提示符或 PowerShell - 验证方式不是双击桌面图标打开终端，而是新开一个终端窗口再运行
go version
go mod init 报 failed to load config: cannot find module root
说明当前目录不在 GOPATH 下，且没启用 Go Modules —— 这在 Go 1.16+ 是默认开启的，但某些旧教程或误删 go.env 会导致它关闭。
- 运行
go env -w GO111MODULE=on强制启用模块模式 - 确保你在项目根目录下执行
go mod init example.com/myapp，不能在$GOPATH/src里随便建个子目录就 init - 如果仍报错，用
go env GOPATH看输出是否为空；若为空，说明 Go 不再强制依赖 GOPATH，此时go mod init必须在空目录或已有代码的根目录运行，不能嵌套在其他 Git 仓库子目录里（除非你明确想初始化子模块）
go get github.com/gin-gonic/gin 超时或连接拒绝
国内直连 golang.org 和 GitHub 的包仓库大概率失败，这不是网络问题，是路由策略导致的。
- 优先设置国内代理：
go env -w GOPROXY=https://goproxy.cn,direct - 如需兼容私有模块，保留
direct在末尾，不要写成https://goproxy.cn单独一项 - 临时绕过代理只对某个包生效：加
-u参数并指定完整 URL，例如go get -u golang.org/x/net@latest可能失败，但go get -u github.com/golang/net@latest（镜像地址）有时更稳 - 不建议关防火墙或换 DNS 来“解决”，本质是协议层被干扰，代理才是正解
真正容易被忽略的点是：Go 安装后不等于环境就绪，go mod 行为受 GO111MODULE、GOPROXY、当前路径三者共同约束，任何一个错位都会让 go run 或 go build 突然失败，而且错误提示往往不指向根源。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
