Go模块缓存异常时，可执行go clean -modcache彻底清除；或手动删除特定模块缓存条目；清理后用go mod verify校验完整性并重新下载；还可通过设置GOMODCACHE到高速存储路径提升性能。
如果您在Mac上使用Go语言开发，发现模块依赖下载异常、版本不一致或磁盘空间被大量占用，则很可能是Go模块缓存（GOMODCACHE）中存在损坏、冗余或过期的模块数据。以下是清理Go语言mod下载缓存的具体方法：
一、使用go clean -modcache命令彻底清除模块缓存
该命令会删除整个$GOMODCACHE目录下的所有内容，包括所有已下载模块的源码、校验文件及压缩包，适用于解决缓存污染、私有代理切换、分支切换后依赖解析失败等问题。
1、打开终端应用。
2、执行以下命令：
立即学习“go语言免费学习笔记（深入）”；
go clean -modcache
3、等待命令执行完成，终端将输出类似cleaned $HOME/go/pkg/mod的提示信息。
4、验证缓存是否清空：运行ls $(go env GOMODCACHE)，应返回No such file or directory或为空目录列表。
二、手动删除特定模块缓存条目
当仅需清理某一个或几个可疑模块（如私有仓库版本异常、校验失败的模块），可避免全局清理带来的重复下载开销，直接定位并移除对应缓存路径。
1、确认当前模块缓存根路径：
go env GOMODCACHE
2、进入缓存目录：
cd $(go env GOMODCACHE)
3、列出所有模块目录：
ls -d */ | head -20
4、定位目标模块（例如github.com/example/lib@v1.2.3），其缓存路径通常为cache/download/github.com/example/lib/@v/v1.2.3.*及对应解压目录github.com/example/lib@v1.2.3。
5、执行删除（以模块github.com/example/lib为例）：
rm -rf github.com/example/lib@v1.2.3 cache/download/github.com/example/lib
三、结合go mod verify校验并重建可信缓存
在清理部分或全部缓存后，可通过校验确保后续拉取的模块与go.sum完全一致，防止因网络中间劫持或代理篡改导致的完整性风险。
1、确保项目根目录下存在有效的go.mod和go.sum文件。
2、执行校验命令：
go mod verify
3、若输出all modules verified，说明本地缓存中现存模块完整可信；若报错，则表明仍有损坏模块残留，需再次执行步骤一或二。
4、触发重新下载所需模块：
go mod download
四、设置GOMODCACHE到独立高速存储路径（可选提速方案）
Mac用户若使用外置SSD或APFS加密卷作为工作区，可将模块缓存迁移至读写更快、空间更充裕的位置，显著提升go mod download与go build速度。
1、创建新缓存目录（例如挂载在/Volumes/SSD/gomod）：
mkdir -p /Volumes/SSD/gomod
2、临时设置环境变量：
export GOMODCACHE=/Volumes/SSD/gomod
3、永久生效（编辑~/.zshrc）：
echo 'export GOMODCACHE=/Volumes/SSD/gomod' >> ~/.zshrc && source ~/.zshrc
4、验证路径变更：
go env GOMODCACHE
5、执行一次go clean -modcache使新路径生效。
