Go 不建议使用全局 GOPATH，因其违背项目隔离、依赖可重现等现代工程要求；自 Go 1.16 起 Module 已成默认方案，支持任意路径、版本锁定和构建一致性。
Go 不建议使用全局 GOPATH，根本原因在于它违背了现代软件工程对项目隔离、依赖可重现、路径自由和协作一致性的基本要求。GOPATH 是 Go 1.11 之前的设计产物，而从 Go 1.16 起，Go Module 已成为默认且唯一推荐的项目组织与依赖管理方式。
项目必须塞进固定路径，太僵硬
GOPATH 强制所有代码放在 $GOPATH/src/github.com/user/project 这类嵌套路径下。这意味着：
- 你不能把项目放在桌面、文档夹或任何你喜欢的位置
- 项目名必须匹配远程仓库路径（比如不能叫
myblog，得叫github.com/you/blog） - 重构或迁移项目时，改路径就可能 break 构建
所有项目共享一套依赖，极易冲突
所有 go get 下载的包都落到同一个 $GOPATH/src 和 $GOPATH/pkg。结果是：
- 项目 A 用 gin v1.6，项目 B 用 v1.9 —— 只能共存一个版本，必有一方出错
- 没有
go.mod记录版本，团队成员拉代码后go build行为可能不一致 - 无法锁定哈希值，
go.sum校验机制完全缺失
没有版本概念，升级就是“赌兼容性”
GOPATH 模式下 go get 默认拉最新 master，不支持 @v1.2.3 语法（早期版本甚至不支持）。后果包括：
OpenClaw 技能 — 给定一个 GitHub 仓库 URL，自动解析出 owner/repo 名称，发现其中的 YAML/properties 配置文件及其配对的中文字段说明；在 `workspace/{repo}/` 目录下按同步日期（格式为 `YYYY-MM-DD`）创建时间戳子目录；写入 `.openclaw-config-state.json` 状态文件。每次用户提问前，先比对远程仓库当前 ref（如 `main` 或 `master`）的最新提交 SHA 与本地状态文件中记录的 SHA：
- 某天上游删了一个函数，你的项目突然编译失败
- CI 流水线今天成功，明天失败，排查困难
- 无法回滚到已知稳定状态，因为没存版本信息
Go Module 已全面接管，GOPATH 成为历史兼容层
现在只需两步就能彻底告别 GOPATH 约束：
-
go mod init myproject—— 在任意目录初始化模块，生成go.mod -
go run main.go或go build—— 自动下载依赖到本地vendor或模块缓存，不再碰 GOPATH
即使你保留 GO111MODULE=on（默认），Go 也会忽略 GOPATH/src 的布局规则；设为 off 才会退化回旧模式 —— 官方明确不鼓励这样做。
基本上就这些。不是 GOPATH “不能用”，而是它早已被更可靠、更灵活、更符合直觉的 Module 模式取代。继续用 GOPATH，就像在 Git 时代坚持用 SVN —— 不违法，但没必要。
