GOPATH 模式是 Go 1.11 前默认依赖管理方式，依赖 GOPATH 环境变量定义工作区，所有代码、包、二进制文件须严格按 $GOPATH/src、pkg、bin 目录结构组织。
什么是 GOPATH 模式
GOPATH 模式是 Go 1.11 之前默认的依赖管理方式，它依赖一个全局 环境变量 GOPATH 来定义工作区位置。所有项目源码、第三方包、编译产物都严格按约定目录结构组织在 $GOPATH/src、$GOPATH/pkg、$GOPATH/bin 下。比如你写一个项目，必须放在 $GOPATH/src/github.com/yourname/project 这样的路径里，否则 go build 或go install会找不到包。
如何启用并配置 GOPATH 模式
启用 GOPATH 模式需要两步：关闭模块（Go Modules），并正确设置 GOPATH 环境变量。
- 关闭模块：执行 go env -w GO111MODULE=off，这会让 Go 工具 链忽略 go.mod 文件，回归传统路径查找逻辑
- 设置 GOPATH：选择一个干净目录（如 $HOME/go 或D:goprojects），创建 src、pkg、bin 子目录
- 写入环境变量：Linux/macOS 加到 ~/.zshrc 或~/.bashrc；Windows 在系统环境变量中新增GOPATH，值为你的工作区根路径
- 把 $GOPATH/bin 加入 PATH，这样go install 生成的命令才能直接运行
- 执行 source ~/.zshrc 或重启终端，再用 go env GOPATH 确认生效
GOPATH 模式 vs 模块（Go Modules）模式核心区别
两者根本差异在于依赖定位方式和项目自由度：
- 项目位置 ：GOPATH 模式强制项目必须在$GOPATH/src 下，且路径要模拟远程仓库结构（如 github.com/user/repo）；模块模式允许项目放在任意路径，只要包含go.mod 文件
- 依赖管理 ：GOPATH 模式下所有项目共享$GOPATH/src 里的包，A 项目升级某个包，B 项目也会“被动升级”；模块模式每个项目有独立 go.sum 和vendor（可选），版本隔离明确
- 构建行为：GOPATH 模式不检查版本，只认本地路径；模块模式默认从代理（如https://goproxy.cn）下载指定版本，并校验哈希
- 适用场景：新项目不建议用 GOPATH 模式；仅在维护非常老的代码库、或某些 CI/CD 流程强依赖旧路径逻辑时才启用
切换回模块模式只需一步
如果你已启用 GOPATH 模式但想恢复现代开发方式，执行：
go env -w GO111MODULE=on
然后在项目根目录运行 go mod init your-module-name 生成 go.mod。之后所有go get、go build 都会按模块规则工作，不再受 GOPATH 路径约束。
立即学习“go 语言免费学习笔记（深入）”；
