常见原因是 PATH 未正确配置，需手动添加 Go 二进制路径；GO111MODULE 默认开启导致 go get 失败，应避免在 $GOPATH/src 下新建项目；GOROOT 不应手动设置，GOPATH 只需指向干净目录；代理需同时配置 GO_PROXY 和 GOPRIVATE。
Go 安装后 go version 报错或找不到命令
常见原因是 PATH 没配对，尤其是 Windows 用户习惯双击安装包，默认勾选“Add to PATH”但实际可能失效；macOS 用 Homebrew 安装后，zsh 用户需检查 ~/.zshrc 是否追加了 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel），而 Go 的二进制默认在 /usr/local/go/bin，必须手动加进去。
实操建议：
立即学习 “go 语言免费学习笔记（深入）”；
- 运行
which go或where go（Windows）确认是否真没找到 - Linux/macOS：在 shell 配置文件末尾加
export PATH=$PATH:/usr/local/go/bin，然后source ~/.zshrc（或~/.bash_profile） - Windows：用系统环境变量界面添加
C:Gobin到Path，** 不要 ** 只改用户变量，管理员权限终端也可能读系统变量 - 重启终端再试，别信“刚 source 就生效”的直觉——某些 IDE 终端缓存旧环境
GO111MODULE 默认开启导致 go get 失败
Go 1.16+ 默认启用模块模式，但新手常把项目放在 $GOPATH/src 下还用老式依赖管理，结果 go get github.com/some/pkg 报 cannot find module providing package。这不是网络问题，是模块感知到当前目录没 go.mod 且不在模块路径中，直接拒绝操作。
实操建议：
立即学习 “go 语言免费学习笔记（深入）”；
- 新建项目别进
$GOPATH/src，直接在任意目录mkdir myapp && cd myapp && go mod init myapp - 临时关闭模块（不推荐长期用）：
GO111MODULE=off go get xxx，但会绕过校验、无法复现生产构建行为 - 如果必须用 GOPATH 工作流（如维护老项目），确保目录结构为
$GOPATH/src/github.com/user/repo，且执行go get时在该目录内 -
go env -w GO111MODULE=on可设全局开启，避免每次敲前缀
GOROOT 和 GOPATH 容易混淆和误配
GOROOT 是 Go 安装根目录（如 /usr/local/go），由安装程序设定，** 不该手动改 **；GOPATH 是工作区，存放 src、pkg、bin，Go 1.13+ 默认为 $HOME/go，但很多人复制网上教程盲目设成 $HOME/go/src，结果 go install 编译的二进制找不到。
实操建议：
立即学习 “go 语言免费学习笔记（深入）”；
- 用
go env GOROOT和go env GOPATH确认当前值，别猜 - 除非有特殊隔离需求（如多版本共存），否则 ** 不要设置
GOROOT**——安装脚本已写死路径 -
GOPATH只需指向一个干净目录（如$HOME/go），go命令会自动在其下建src等子目录 -
go install生成的可执行文件放在$GOPATH/bin，记得把这个路径也加进PATH，否则运行报command not found
代理配置不当引发 go get 卡住或超时
国内访问 proxy.golang.org 不稳定，但新手常只配 GO_PROXY，漏掉 GOPRIVATE，结果公司私有模块（如 git.internal.company.com/xxx）也被代理转发，404 或鉴权失败。
实操建议：
立即学习 “go 语言免费学习笔记（深入）”；
- 设公共代理：
go env -w GO_PROXY=https://goproxy.cn,direct（direct表示匹配后不走代理的兜底规则） - 私有域名必须加
GOPRIVATE：go env -w GOPRIVATE=git.internal.company.com,github.com/myorg - 验证是否生效：
go env | grep -E "(GO_PROXY|GOPRIVATE)" - 临时调试可用
curl -v https://goproxy.cn/github.com/gorilla/mux/@v/list看代理是否通，比等go get卡 2 分钟更直接
环境变量的拼写、路径斜杠方向、shell 配置文件加载时机——这些地方不报错，但会让整个流程静默失败。宁可多敲一遍 go env，也别靠记忆硬写 GOROOT。
