最常翻车的是“装上了但用不了”：PATH未正确配置导致command not found、GO111MODULE未设on致go get失败、GOROOT设错引发构建异常，三者占90%报错根源。
Go 环境搭建最常翻车的不是“装不上”，而是“装上了但用不了”——PATH 没配对、GOROOT 设错、GO111MODULE 和 GOPROXY 混用，三者占了 90% 的报错根源。
go 命令找不到：PATH 配置漏掉或写错路径
这不是安装失败，是系统压根没看见 go。典型现象：command not found: go 或 zsh: command not found: go。
- 确认 Go 实际解压位置：比如
/usr/local/go（macOS/Linux）或C:\Go（Windows），再检查/usr/local/go/bin/go是否存在 - Zsh 用户（macOS Catalina+ / 多数 Linux）必须改
~/.zshrc，加这行：export PATH="/usr/local/go/bin:$PATH" - Bash 用户改
~/.bashrc或~/.bash_profile，内容一样 - Windows 用户进「系统属性 → 高级 → 环境变量」，把
C:\Go\bin加进「系统变量」或「用户变量」的Path（注意不是新建变量） - 改完一定要重载：
source ~/.zshrc（或对应文件），再跑go version验证
go get 报 failed to load mod file：GO111MODULE=on 但当前目录没 go.mod
这不是网络问题，是 Go 拒绝在非模块上下文里写依赖。现象：go: failed to load mod file，尤其在空目录或 $GOPATH/src 下执行时高频出现。
- 想初始化新项目？先运行
go mod init example.com/myapp（模块名任意，不需真实存在） - 只是装工具（如
gopls、air）？加-d参数跳过构建：go install golang.org/x/tools/gopls@latest -d - 误在
$GOPATH/src下操作？直接cd出去，换到任意空目录再试 —— Go 1.16+ 默认禁用 GOPATH 模式 - CI/CD 构建时也得确保工作目录有
go.mod，否则go build可能静默失败
GOROOT 被手动覆盖导致构建失败
GOROOT 应该只指向 Go 安装根目录（如 /usr/local/go），不是你放项目的目录。设错后常见表现：build failed: cannot find module providing package 或 go: cannot find main module。
立即学习“go语言免费学习笔记（深入）”；
- 查当前值：
go env GOROOT，如果输出是/home/user/go或类似路径，基本就是被错误覆盖了 - 搜所有 shell 配置文件：
grep -r "GOROOT=" ~/.zshrc ~/.profile ~/.bashrc 2>/dev/null，删掉类似export GOROOT=$HOME/go的行 - 别在项目里放
.env或go.env文件偷偷改GOROOT，这类覆盖极难排查 - GOROOT 和 GOPATH 必须分离：前者是 Go 自身安装路径，后者（默认
$HOME/go）是工作区，混用必崩
国内拉不到 golang.org/x 模块：GOPROXY 没开或配置冲突
现象：go: failed to download golang.org/x/net v0.0.1: Get https://proxy.golang.org/: dial tcp: i/o timeout，本质是模块代理没生效。
- 必须同时启用 Modules 和代理：
export GO111MODULE=on+export GOPROXY=https://goproxy.cn,direct - 别只设
GOPROXY却漏了GO111MODULE=on，后者关着时GOPROXY不起作用 - 私有模块要跳过代理？加
GOPRIVATE：export GOPRIVATE=git.company.com，多个用逗号分隔 - 验证代理是否生效：运行
go env GOPROXY，输出应为设置的地址，不是https://proxy.golang.org
真正卡住人的从来不是“怎么装”，而是装完之后发现 go 命令不可用、go get 死在第一行、或者 go build 报一堆找不到包——这些全是环境变量和上下文状态的隐性冲突，查起来费时间，但修复就几行配置。
