Go 1.11 后模块缓存（$GOPATH/pkg/mod）取代 GOPATH/src 管理依赖，GOPATH 仅用于存放工具（bin）和旧式构建产物（pkg），src 不再存第三方包；模块缓存由 Go 自动维护，不可手动修改，路径通过 GOPATH 间接控制。
Go 1.11 引入模块（modules）后，GOPATH 不再是依赖管理的核心路径，但它的角色和 go mod cache（模块缓存）仍需清晰区分与协同使用。关键点在于：现代 Go 项目应以 go.mod 为依赖声明中心，模块缓存自动管理下载的包副本，而 GOPATH 仅在特定场景（如构建非模块项目或存放本地工具）仍有作用。
理解 GOPATH 的当前定位
GOPATH 默认为 $HOME/go（Linux/macOS）或 %USERPROFILE%\go（Windows），它包含三个子目录：src、pkg、bin。但在模块模式下：
-
src不再用于存放第三方依赖 —— 这些由模块缓存统一管理 -
pkg主要存放编译生成的归档文件（如.a），仅对非模块构建或go install旧式用法仍有意义 -
bin仍用于存放通过go install安装的可执行工具（如golangci-lint），无论是否在模块中
模块缓存（mod cache）的位置与结构
Go 将所有下载的模块版本存放在 $GOCACHE 下的 download 子目录（实际路径为 $GOCACHE/download），但更常用的是 $GOPATH/pkg/mod —— 这才是模块缓存的主存储区（即使项目不在 GOPATH/src 中也会写入此处）。
典型结构如下：
立即学习“go语言免费学习笔记（深入）”；
$GOPATH/pkg/mod/ ├── cache/ # 下载元数据与校验信息（如 .info, .ziphash） ├── github.com/...@v1.2.3/ # 解压后的模块源码（带版本后缀） ├── golang.org/x/net@v0.25.0/ └── ...
该目录由 Go 工具链自动维护，不应手动修改。
日常缓存管理操作
无需频繁干预，但以下命令可应对常见需求：
-
go mod download：预加载go.mod中所有依赖到本地缓存（适合 CI 环境提前拉取） -
go clean -modcache：彻底清空整个$GOPATH/pkg/mod缓存（谨慎使用，会触发后续构建重新下载） -
go mod verify：校验已缓存模块的go.sum签名是否匹配，防止篡改 - 查看缓存大小：
du -sh $GOPATH/pkg/mod（Linux/macOS）或Get-ChildItem $env:GOPATH\pkg\mod | Measure-Object -Property Length -Sum（PowerShell）
避免 GOPATH 与模块缓存混淆的实践
常见误区包括误删 $GOPATH/src 影响模块、或以为设置 GOPATH 能改变模块缓存位置。正确做法是：
- 不将项目放在
$GOPATH/src下启动模块开发（除非刻意兼容旧工作流） - 模块缓存路径不可直接配置；若需迁移，只能通过设置
GOPATH实现（例如GOPATH=/data/go go build） - 使用
go env GOPATH和go env GOCACHE确认当前路径，避免多版本 Go 或 shell 环境导致的不一致 - 团队中统一
GO111MODULE=on（推荐设为默认），避免因GOPATH下存在go.mod导致意外启用模块模式
