go clean -modcache 不能解决“过期缓存”问题，因其清空整个模块缓存而非智能识别并删除未被任何 go.mod 引用的冗余 module@version；go 官方无内置命令判断冗余项，需结合 go list -m all 和缓存文件解析实现精准清理。
为什么 go clean -modcache 不能直接解决“过期缓存”问题
Go 的模块缓存（$GOPATH/pkg/mod）本身不标记“过期”，它只按 module@version 存储，不会自动删除未被当前项目引用的旧版本。你执行 go clean -modcache 是清空整个缓存，而非“智能清理过期项”——这会导致后续 go build 或 go test 大量重下载，尤其在 CI 或多项目共用 GOPATH 时很伤。
如何识别哪些模块缓存实际已“冗余”
真正需要清理的是：那些不在任何本地 go.mod 中被直接或间接引用的 module@version。Go 官方没提供内置命令做这个判断，但可借助 go list 和 go mod graph 构建依赖快照。
- 运行
go list -m all获取当前模块及其所有传递依赖（含版本号），这是“活跃集合” - 遍历
$GOPATH/pkg/mod/cache/download下的.zip和.info文件，提取模块名和版本（如golang.org/x/text@v0.15.0.info） - 注意：
go list -m all输出不含校验和，而缓存文件名含h1-xxx后缀，匹配时需截断哈希部分，只比对module@version - Windows 用户注意路径分隔符：
$env:GOPATH而非$GOPATH，且pkg\mod\cache\download
一个轻量、可复用的 Bash 脚本示例（Linux/macOS）
#!/bin/bash
set -euo pipefail
<p>MODCACHE="${GOPATH}/pkg/mod"
DOWNLOAD_DIR="${MODCACHE}/cache/download"</p><h1>获取当前工作目录下所有 go.mod 的活跃依赖（去重）</h1><p>ACTIVE_DEPS=$(mktemp)
trap 'rm -f "$ACTIVE_DEPS"' EXIT</p><p>find . -name 'go.mod' -execdir sh -c '
cd "$1" && go list -m all 2>/dev/null || true
' _ {} \; | cut -d' ' -f1 | sort -u > "$ACTIVE_DEPS"</p><h1>遍历缓存中的 .info 文件，提取 module@version</h1><p>for f in "$DOWNLOAD_DIR"/<em>/</em>/*.info; do
[[ -f "$f" ]] || continue</p><h1>提取 golang.org/x/net@v0.25.0 格式（去掉 h1-xxx 部分）</h1><p>MOD_VER=$(basename "$f" | sed 's/.[^.]<em>.info$//' | sed 's/.h1-.</em>$//')
if ! grep -q "^$MOD_VER$" "$ACTIVE_DEPS"; then
echo "Removing unused: $MOD_VER"
rm -f "$f" "${f%.info}.zip" "${f%.info}.zip.extracted"
fi
done</p>
这个脚本只删 .info 及关联的 .zip 和解压目录，不动 cache/download 外的 cache/vcs 或 pkg/mod/xxx ——后者由 Go 自动管理，删了反而可能破坏符号链接。
Windows PowerShell 版本要注意的坑
PowerShell 对通配符和路径处理更严格，Get-ChildItem "$DOWNLOAD_DIR\*\*\*.info" 可能因层级过深失败；建议改用 Get-ChildItem -Recurse 并加 -Depth 4 限制。
- 模块名解析要用
[System.IO.Path]::GetFileNameWithoutExtension()替代sed，再手动切掉.h1-后缀 -
go list -m all在 Windows 上可能因编码问题输出乱码，建议在脚本开头加$OutputEncoding = [Console]::OutputEncoding = [System.Text.Encoding]::UTF8 - 别直接删
pkg/mod下的cache目录——那是 Go 内部用的临时区，删了会导致go mod download报no such file or directory
真正麻烦的不是脚本怎么写，而是“哪些缓存算过期”本身没有统一定义：不同项目可能依赖同一模块的不同版本，删掉某个 @v1.2.3 可能让另一个项目下次构建变慢甚至失败。所以这类脚本最好只在开发机定期跑，别放进 CI 流水线。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
