“go command not found”最直接原因是PATH未正确配置，99%为Go的bin目录（如/usr/local/go/bin）未加入PATH，需确认安装路径、编辑对应shell配置文件（如~/.zshrc）、执行source生效并重启终端验证。
go command not found 是 PATH 没配对最直接的信号
系统找不到 go 命令，99% 是因为 /usr/local/go/bin（或你实际安装路径下的 bin）没进 PATH。别急着重装，先确认 Go 是否真在那儿：
- 运行
ls -l /usr/local/go/bin/go（Linux/macOS）或dir C:\Go\bin\go.exe（Windows），看文件是否存在 - 如果存在，检查 shell 配置文件：Zsh 用户看
~/.zshrc，Bash 用户看~/.bashrc或~/.bash_profile，Windows 用户查「系统属性 → 环境变量」 - 确保写了类似
export PATH="/usr/local/go/bin:$PATH"（Linux/macOS）或把C:\Go\bin加进 Path（Windows） - 改完必须
source ~/.zshrc（或对应文件），再开新终端验证go version
常见坑：改了配置但忘了 source，或者终端没重启，echo $PATH 里压根没看到 Go 的 bin 路径。
go mod init 失败或 go get 报 failed to load mod file
这不是网络问题，是当前目录没模块上下文。Go 1.16+ 默认拒绝在无 go.mod 的目录里写依赖。
- 如果你要新建项目，先跑
go mod init example.com/myapp（模块名随便起，不需真实存在） - 如果你只是想装工具（比如
gopls），加-d参数：go install golang.org/x/tools/gopls@latest—— 注意不是go get - 别在
$GOPATH/src下执行这些命令，Go Modules 已弃用该路径，进去就容易报错 - 确认没误设
GO111MODULE=off，运行go env GO111MODULE应输出on
错误提示里带 failed to load mod file，基本就是目录里缺 go.mod，别往代理或网络上瞎折腾。
立即学习“go语言免费学习笔记（深入）”；
GOROOT 指向错误导致构建失败
GOROOT 只应指向 Go 安装根目录（如 /usr/local/go），不是项目目录，也不是 $HOME/go。设错会引发标准库版本错乱、import "fmt" 都失败。
- 运行
go env GOROOT，输出必须和你实际安装路径一致；若显示/home/user/go这类明显不对的路径，说明被覆盖了 - 全局搜索所有 shell 配置文件（
~/.zshrc、~/.profile、/etc/profile），删掉类似export GOROOT=$HOME/go的行 - 检查项目根目录下有没有
.env或go.env文件偷偷改了GOROOT - 改完后重启终端，再跑
go env GOROOT和go build测试
这个错常被误判为“包找不到”，其实根源是编译器和标准库版本对不上，现象可能是 object is [xxx] expected [yyy] 这类低级但难定位的报错。
依赖下载慢或超时，别硬等 proxy.golang.org
国内直连 proxy.golang.org 基本必超时，但换代理前先确认是否真卡在这儿：
- 运行
go env GOPROXY，如果不是https://goproxy.cn,direct或https://mirrors.aliyun.com/goproxy/,direct，就立刻设上 - 设法：
go env -w GOPROXY=https://goproxy.cn,direct - 顺手关掉校验：
go env -w GOSUMDB=off（仅开发机，生产环境慎用） - 私有模块？加
go env -w GOPRIVATE=git.company.com，避免走代理
注意 direct 必须跟在代理 URL 后面，用逗号分隔，漏了会导致部分模块绕过代理仍失败；GOPROXY 设错比网络差更致命。
