Go 1.22+ 已完全弃用 GOPATH 模式，直接用 go mod 即可运行，无需配置 GOPATH 或将代码放入 $GOPATH/src 目录；配了反而易出错，go version 报错或命令找不到实为 PATH 配置错误。
Go 1.22+ 已完全弃用 GOPATH 模式，直接用 go mod 就能跑，不用配 GOPATH，也不用把代码扔进 $GOPATH/src 目录里——配了反而容易出错。
go version 报错或找不到命令
这是 PATH 没设对，不是 Go 没装好。Windows 安装时勾选“Add to PATH”最省事；macOS/Linux 手动加路径时，别只写 /usr/local/go/bin 就完事，得确认它真在你的 shell 配置里生效：
- 检查是否漏写了
export PATH=$PATH:/usr/local/go/bin（macOS/Linux）或没重启终端 - Windows 用户如果改过安装路径（比如装到
D:\Go），就得手动把D:\Go\bin加进系统环境变量，不能依赖默认值 - 运行
which go（macOS/Linux）或where go（Windows）看输出路径是否和你装的位置一致
go mod init 失败：module declares its path as … but was required as …
这是模块路径和实际目录结构不匹配的典型报错，常见于复制旧项目、重命名文件夹或从 GitHub clone 后没改 go.mod。根本原因不是网络或代理问题，而是本地路径和模块声明对不上：
- 删掉当前目录下的
go.mod和go.sum，重新执行go mod init your-module-name（名字建议用域名前缀，如github.com/yourname/project） - 如果项目已提交到 Git，确保
go mod init在仓库根目录执行，否则会生成错误的模块路径 - 别用中文路径、空格或特殊字符命名项目目录，
go mod解析时会出问题
国内拉包超时或 404：proxy 设置不生效
Go 1.13+ 默认启用代理，但 GO111MODULE=on 必须开启，且代理地址必须带协议（https://），否则会被忽略：
立即学习“go语言免费学习笔记（深入）”；
- 设置命令（推荐全局）：
go env -w GOPROXY=https://proxy.golang.org,direct（官方代理在国内不稳定，可换为https://goproxy.cn或https://mirrors.aliyun.com/goproxy/） - 验证是否生效：
go env GOPROXY输出应为完整 URL，不含空格或引号 - 某些公司内网会拦截
direct回源，此时需去掉,direct，强制走代理，或配置私有 proxy
真正容易被忽略的是：Go Modules 的依赖解析是静态的，go get 不会自动更新 go.mod 里已有版本，除非显式指定版本号或加 -u 参数；而 go run 临时执行时若依赖缺失，会静默下载，但不会写入 go.mod —— 这导致协作时别人 go build 失败，你却毫无察觉。
