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语言免费学习笔记（深入）”；
