真正有效的清理命令只有 go clean -modcache，它安全、幂等地清空 $GOMODCACHE 中的模块缓存，不影响 go.mod、go.sum 或 vendor，后续构建按需下载缺失或校验失败的模块。
gofr clean 不存在，别被误导
Go 官方没有 go clean -modcache 之外的“一键清理模块依赖缓存”的高级命令，gofr、gomodclean 等第三方工具要么已过时，要么不处理真实缓存路径。直接删错目录会导致后续 go build 或 go run 反复重下，甚至破坏 vendor 一致性。
真正有效的清理命令只有 go clean -modcache
这是 Go 自带、安全、幂等的操作，它只清空 $GOMODCACHE（默认是 $GOPATH/pkg/mod）里的下载包，不影响 go.sum、go.mod 或本地 vendor 目录。
- 运行前确认当前 Go 版本支持该 flag（Go 1.12+ 全部支持）
- 执行后不会改变你的项目依赖声明，只是清掉磁盘上已缓存的 zip/tar 包和解压后的源码
- 下次构建时会按需重新下载——但仅限缺失或校验失败的模块，不是全部重拉
- 如果想预估空间释放量，先运行
du -sh $(go env GOMODCACHE)
手动删 modcache 目录的风险点
有人图快直接 rm -rf $GOPATH/pkg/mod，这看似等效，但容易出问题：
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 多个 GOPATH 或使用
GOBIN/GOPATH混用时，go env GOMODCACHE和实际路径可能不一致 - 正在运行的
go进程（比如 IDE 后台分析）可能正读取该目录，强制删除引发 I/O 错误 - 某些 CI 环境里
GOPATH未显式设置，go env GOPATH返回空，导致删错位置 - 删完没重跑
go mod download就执行构建，会卡在“downloading”状态，而非报错提示
清理后要不要重新下载所有依赖？
不需要主动触发全量下载。Go 工具链会在需要时按需拉取，但以下场景建议手动补全：
立即学习“go语言免费学习笔记（深入）”；
- 你刚切换了 Go 版本（比如从 1.19 升到 1.22），部分模块缓存可能被跳过校验，运行
go mod download更稳妥 - CI 构建前想确保环境干净且可复现，可在
go clean -modcache后加go mod download -x（-x显示每一步下载过程） - 发现
go list -m all输出里有(incompatible)或missing，说明缓存损坏，此时清理 +go mod tidy才是完整修复
缓存路径本身不保存版本语义，只存原始压缩包和解压副本；真正决定用哪个版本的是 go.mod 和 go.sum。别把清理当“解决依赖冲突”的银弹——它只是腾空间，不是修依赖逻辑。
