Go环境安装失败主因是PATH未生效或GOPROXY未配置，需先验证go version，再执行go env -w GOPROXY=https://goproxy.cn,direct并确认go env GOPROXY输出正确，必要时加go env -w GOSUMDB=sum.golang.org。
Go 环境装不上，八成卡在 GOPROXY 或 PATH 没生效，不是 Go 本身难，是默认直连 proxy.golang.org 在国内根本连不上。
验证是否真装上了：别信安装包点了“Finish”
打开终端（Windows 是 CMD/PowerShell，macOS/Linux 是 Terminal），执行：
go version
如果报错 command not found 或 'go' is not recognized，说明 PATH 没配对——哪怕你用的是官方 .msi/.pkg 安装包，某些 macOS Apple Silicon 或旧版 Windows 仍会漏写路径。检查方式：
- Windows：运行
echo %PATH%，确认含C:\Program Files\Go\bin（或你自定义的安装路径） - macOS/Linux：运行
echo $PATH，确认含/usr/local/go/bin（pkg 默认）或你解压的/your/path/go/bin - 改完记得重启终端，或执行
source ~/.zshrc（macOS）/source ~/.bashrc（Linux）
必须立刻配置 GOPROXY：否则 go mod tidy 会卡死
国内不设镜像，go get、go mod download、go mod tidy 基本无法完成，超时后直接失败。执行这一条命令即可：
立即学习“go语言免费学习笔记（深入）”；
go env -w GOPROXY=https://goproxy.cn,direct
注意逗号后是 direct，不是 https://proxy.golang.org ——这是关键 fallback 机制，确保私有模块（如公司内网 Git）不受影响。验证是否生效：
go env GOPROXY
输出应为 https://goproxy.cn,direct。若没生效，检查是否用了 PowerShell 而非管理员权限，或终端未重载 shell 配置。
初始化项目时绕过 GOPATH 陷阱：go mod init 是唯一入口
Go 1.16+ 已弃用 GOPATH 作为依赖根目录，新手常误以为要先建 $GOPATH/src 目录再放代码——完全不必。正确流程只有三步：
- 新建空目录：
mkdir myapp && cd myapp - 初始化模块：
go mod init myapp（模块名建议用域名格式，如github.com/you/myapp，避免后续引入冲突） - 写
main.go后直接go run main.go，无需go install或手动管理bin目录
此时生成的 go.mod 里会自动记录 Go 版本（如 go 1.23），这个版本号决定编译行为，比系统全局 Go 版本更优先。
常见卡点：checksum mismatch 和 GOSUMDB
执行 go mod tidy 时突然报错 verifying github.com/some/pkg@v1.2.3: checksum mismatch，大概率是 GOSUMDB 校验服务器不可达。临时解决（仅开发机）：
go env -w GOSUMDB=off
但生产环境不能关，应改用：
go env -w GOSUMDB=sum.golang.org
并确保 GOPROXY 已设为 https://goproxy.cn,direct ——因为 sum.golang.org 也需代理才能访问。真正稳定的组合是：
go env -w GOPROXY=https://goproxy.cn,direct<br>go env -w GOSUMDB=sum.golang.org
这两行缺一不可，且顺序无关。
最易被忽略的是：go env -w 写入的是用户级配置，换终端、换 Shell（比如从 zsh 切到 bash）可能失效；而 GOPRIVATE 规则（用于跳过私有仓库校验）必须和 GOPROXY 一起设，否则内网模块拉不到——这些细节不报错，但会让依赖静默失败。
