go命令不可用的根本原因是PATH未正确配置或存在多版本冲突，需验证which go与go env GOROOT是否一致，并确保新环境变量已加载；模块模式需显式设置GO111MODULE=on，依赖代理还需配置GOSUMDB=off。
go version 报错或找不到命令？先确认二进制路径是否真在 PATH 里
很多“安装成功但 go 命令不可用”的问题，根本不是没装好，而是终端没读到新环境变量，或者 PATH 混入了多个 go 二进制路径导致冲突。
- Windows：必须关闭所有已打开的 CMD/PowerShell 窗口，再新开一个——
msi安装器写入的注册表环境变量不会热更新 - macOS/Linux：检查
which go输出路径，再对比go env GOROOT；若两者不一致（比如/usr/local/go/bin/govs/opt/homebrew/bin/go），说明有旧版残留 - 别信
echo $PATH里看到/usr/local/go/bin就万事大吉——要实际执行/usr/local/go/bin/go version看是否能跑
go mod init 后 go run 报错“no required module provides package”？模块模式没真正启用
Go 1.16+ 默认开启模块模式，但某些旧 shell 配置或 IDE 缓存会绕过 GO111MODULE=on，导致 go run 仍按 GOPATH 模式查找包。
- 运行
go env GO111MODULE，输出必须是on；如果不是，立即执行go env -w GO111MODULE=on -
go mod init必须在项目根目录下执行，且该目录不能是$GOPATH/src子目录（否则会降级为 GOPATH 模式） - 如果项目已有
vendor/目录但没go.mod，删掉vendor/再go mod init，否则go run可能误读 vendor 而跳过模块解析
依赖拉不下来、超时、报 “proxy.golang.org:443: dial tcp”？代理配置漏了关键参数
只设 GOPROXY 不够，国内网络下还必须禁用校验和数据库回源，否则 go get 会卡在 sum.golang.org 连接上。
- 正确三行命令（Windows PowerShell）：
go env -w GO111MODULE=ongo env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=off -
GOSUMDB=off是关键：它禁用校验和验证，避免因无法访问sum.golang.org导致整个依赖流程中断 - 验证是否生效：
go env | findstr "GOPROXY\|GOSUMDB"（Windows）或go env GOPROXY GOSUMDB（macOS/Linux）
编译慢？别用 go build -o 单文件打包，改用 go install .
go build -o 生成的是静态链接可执行文件，每次都会重编译全部依赖；而 go install . 会复用 $GOPATH/pkg 缓存的已编译包，后续编译快 3–5 倍。
立即学习“go语言免费学习笔记（深入）”；
- 前提：确保
$GOPATH/bin已加入 PATH，且当前目录有go.mod - 执行
go install .后，直接输入命令名（如myapp）就能运行，无需指定路径 - 注意点：如果项目不在
$GOPATH/src下，go install .仍可用——模块模式下它只依赖go.mod，与 GOPATH 无关
最常被忽略的其实是 GOSUMDB=off 和 go install . 的缓存机制。很多人反复重装 Go、换镜像，却卡在同一个校验和校验环节上；也有人写完代码习惯性 go build -o app.exe，结果每次改一行都要等 8 秒，其实只是没意识到 go install 才是日常开发的编译主力。
