仓库缓存清理¶

清理仓库里的 Python 缓存目录和常见构建产物。

目标¶

删除 __pycache__、*.egg-info、dist/、build/ 等缓存目录，保持仓库干净。

脚本入口¶

# 预览将要删除的内容
bash tools/cache-cleanup.sh --dry-run

# 执行清理
bash tools/cache-cleanup.sh

常用命令¶

# 清理当前目录及子目录的所有 __pycache__
find . -type d -name "__pycache__" -exec rm -rf {} +

# 清理 .pyc 文件
find . -type f -name "*.pyc" -delete

# 清理 egg-info
find . -type d -name "*.egg-info" -exec rm -rf {} +

脚本参数¶

• --root <path>：指定清理根目录，默认是仓库根目录
• --dry-run：只打印将删除的目录，不真正删除
• --include-env-dirs：连 .venv、venv、env、node_modules、.tox、.mypy_cache 里的 __pycache__ 一起清理

输出解释¶

• 删除目录数和文件数会打印到终端
• 返回码 0 表示成功

推荐使用时机¶

• 切换 Python 版本后
• 提交代码前
• CI 构建前
• 磁盘空间不足时

返回码约定¶

评论