Golang的module机制通过本地缓存存储下载的依赖模块，减少重复下载的开销，提升项目构建效率。随着开发过程中依赖的增删，缓存目录会积累大量不再被任何项目使用的无用module文件，需要定期清理。
Golang module缓存的基础信息
缓存存储路径
Golang的module缓存默认存放在$GOPATH/pkg/mod目录下，如果你的环境中没有设置GOPATH，默认路径为$HOME/go/pkg/mod。可以通过下面的命令查看当前的缓存路径：
// 查看GOPATH路径，缓存目录为GOPATH下的pkg/mod go env GOPATH
缓存内容说明
缓存目录中每个依赖模块会以模块路径@版本号的格式存储，比如github.com/gin-gonic/gin@v1.9.0就是一个具体的缓存项，里面包含该版本模块的源码和元数据。
Golang module cache的默认管理方式
Golang本身提供了多个内置指令来管理module缓存，不需要额外安装工具：
- go mod download：下载指定模块到缓存，若不带参数则下载当前项目所有依赖到缓存
- go mod verify：校验缓存中的模块是否被篡改，确保依赖完整性
- go clean -modcache：清理全部module缓存，执行后
$GOPATH/pkg/mod目录下的所有内容都会被删除 - go mod tidy：整理当前项目的依赖，移除不需要的依赖记录，但不会直接清理缓存
如何清理无用module缓存
清理全部缓存
如果需要清空所有本地module缓存，直接使用go clean的内置指令即可，操作非常简单：
# 清理全部module缓存，执行后所有缓存的依赖都会被删除 go clean -modcache
该操作会将$GOPATH/pkg/mod目录下的所有文件删除，下次构建项目时会重新下载需要的依赖。
清理指定项目的无用缓存
如果只想清理当前项目不再使用的依赖缓存，不需要删除全部缓存，可以通过以下步骤操作：
首先执行go mod tidy整理当前项目的依赖，移除go.mod和go.sum中不再被引用的依赖记录：
// 整理当前项目依赖，移除无用依赖记录 go mod tidy
然后可以通过脚本对比当前项目依赖和缓存中的内容，删除未被引用的缓存项，不过Golang没有内置的精准清理指令，如果你需要保留常用依赖的缓存，建议先备份$GOPATH/pkg/mod目录，再执行全量清理后重新构建常用项目，让需要的依赖重新进入缓存。
注意事项
- 执行
go clean -modcache前请确认没有正在进行的项目构建操作，避免构建失败 - 缓存清理后，首次构建项目时需要重新下载依赖，可能受网络环境影响速度较慢
- 如果你使用多GOPATH环境，需要确认当前生效的GOPATH路径，避免误删其他路径下的缓存
定期清理无用module缓存可以有效释放磁盘空间，建议每隔一段时间对开发环境做一次缓存整理，保持环境整洁。
Golangmodule_cachego_cleango_mod依赖管理修改时间：2026-06-29 13:27:26