go version报command not found是因为PATH未包含Go的bin目录，需确认安装路径、正确编辑对应shell配置文件（如zsh用户改~/.zshrc）、添加export PATH=$PATH:/usr/local/go/bin并source生效，Windows则须将C:\Go\bin加入系统环境变量PATH。
go version 报 command not found 怎么办
说明：终端找不到 go 命令，本质是 PATH 没包含 Go 的可执行目录。不是没装，而是 shell 找不到。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先确认 Go 是否真已安装：
ls /usr/local/go/bin/go（macOS/Linux）或dir "C:\go\bin\go.exe"（Windows），存在才继续 - Mac/Linux 用户：检查你改的是哪个 shell 配置文件 ——
zsh用户该改~/.zshrc，bash用户该改~/.bash_profile，混用会失效 - Windows 用户：必须把
%GOROOT%\bin加进「系统环境变量」的PATH，而不是「用户变量」—— 否则某些终端（如 VS Code 集成终端）可能读不到 - 改完配置后别忘了重载：
source ~/.zshrc（Mac/Linux），或重启终端（Windows）；用echo $PATH或echo %PATH%看新路径是否在其中
GOPATH 和 GOROOT 为什么总被搞混
说明：GOROOT 是 Go 安装位置（比如 /usr/local/go），GOPATH 是你写代码、放依赖的地方（比如 $HOME/go）。Go 1.16+ 默认启用 module 模式，GOPATH 对构建影响变小，但它仍控制 go install 输出二进制的位置。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
-
GOROOT一般不用手动设 —— Homebrew 或官方安装包会自动配置；只有解压 tar.gz 到自定义路径时才需显式设置 -
GOPATH如果不设，Go 会用默认值（$HOME/goon Unix,%USERPROFILE%\goon Windows）；但如果你用go install安装命令行工具（如gopls），它会放到$GOPATH/bin，所以这个目录也得在PATH里 - 常见错误：把
GOPATH设成和GOROOT一样（比如都设成/usr/local/go）—— 这会导致go get失败，因为 Go 不允许在GOROOT下写入
go env 显示的值和 echo $GOPATH 不一致
说明：go env 读的是 Go 内部解析后的最终值，而 echo $GOPATH 只是当前 shell 的变量快照。两者不一致，大概率是 shell 启动时没加载最新配置，或者 Go 在启动时覆盖了变量。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 运行
go env -w GOPATH=$HOME/mygopath会写入 Go 的配置文件（$HOME/go/env），优先级高于 shell 变量；想还原就用go env -u GOPATH - 如果
go env GOPATH显示正确，但go list或go build仍报找不到包，检查当前目录是否在$GOPATH/src下（旧式 GOPATH 模式要求）；module 模式下只要目录含go.mod就可脱离GOPATH - Windows 用户特别注意：
go env显示的路径可能是正斜杠/c/Users/xxx/go，但 PowerShell 的$env:GOPATH显示的是C:\Users\xxx\go—— 这是 Cygwin/msys2 风格路径转换，不影响使用，但别拿它去手动创建目录
go proxy 超时或拉不到包，但 go version 没问题
说明：go version 成功只代表 Go 工具链可用，不代表网络能连上模块代理。国内直连 proxy.golang.org 基本不可用，必须换镜像。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 设代理：运行
go env -w GOPROXY=https://goproxy.cn,direct（推荐）或https://mirrors.aliyun.com/goproxy/ - 关校验（仅临时调试）：
go env -w GOSUMDB=off；生产环境建议保留校验，改用可信镜像（如阿里云支持GOSUMDB=sum.golang.org） - 验证代理是否生效：运行
go env GOPROXY，再试go list -m github.com/gin-gonic/gin—— 成功返回版本号即通 - 注意：某些企业内网会拦截 HTTPS 请求，若镜像站也失败，可尝试用
go mod download+ 本地缓存，或配私有 proxy
环境变量生效与否，关键不在“设没设”，而在“哪个进程读到了哪一层”。shell 启动、IDE 启动方式、Go 自身的 env 机制，三层叠加容易漏掉一层。最稳妥的做法：每次改完，新开终端，跑 go env 和 which go 双验证。
