真正可清理的临时文件需满足三点：无进程占用（用lsof/handle检查）、非硬链接引用（st_nlink=1）、不在系统白名单内；优先按路径模式匹配（如/__pycache__/），用pathlib.rglob安全遍历，删除前resolve路径、校验权限并模拟运行。
如何识别真正可清理的临时文件和缓存
不是所有带 tmp、cache 字样的目录都能删——误删 __pycache__ 可能不影响运行，但删掉 .pytest_cache 会导致测试重复生成；更危险的是某些应用（如 VS Code）把扩展缓存放在 ~/.vscode/extensions/xxx/cache，删了会重装扩展。关键看三点：是否有进程正在写入、是否被硬链接引用、是否在系统白名单内。
- 用
lsof +D /path（Linux/macOS）或handle.exe -u /path（Windows）检查文件是否被占用 - 用
os.stat().st_nlink判断硬链接数，为 1 才相对安全 - 优先匹配路径模式而非文件名，例如
**/__pycache__/**比*.pyc更准，避免误杀pyc格式的合法模块
用 pathlib 安全遍历并过滤过期文件
os.walk 容易漏掉符号链接目标，且不支持 glob 模式嵌套；pathlib.Path.rglob 更直观，但默认不跟随 symlink，需显式加 follow_symlinks=False 防止跳进 /proc 或挂载点。
- 按修改时间过滤：用
file.stat().st_mtime而非file.lstat().st_mtime，避免 symlink 自身时间干扰 - 排除保护路径：构建白名单列表，如
[Path.home() / ".local/share/flatpak", Path("/var/lib/docker")]，逐个比对file.resolve()是否在其子路径内 - 避免递归进入
node_modules或venv：用if "node_modules" in str(file.parent) or "venv" in str(file.parent): continue简单跳过（比正则快且不易误判）
删除前必须做原子化预检与模拟运行
直接 unlink() 或 rmtree() 是高危操作，尤其当路径含空格、Unicode 或 .. 时容易越界。真实场景中，90% 的误删源于路径解析错误而非逻辑判断失误。
- 统一用
file.resolve(strict=True)获取绝对路径，捕获FileNotFoundError提前暴露坏链接 - 模拟运行时只打印路径，并统计总大小：
sum(f.stat().st_size for f in candidates)，避免du -sh外部调用带来的兼容性问题 - 对每个待删项执行
os.access(file, os.W_OK)检查写权限，跳过只读文件（如某些/tmp下的 root 创建文件），防止中断流程
为什么不用 shutil.rmtree 直接清空整个缓存目录
因为 shutil.rmtree 不区分文件类型、不校验占用状态、不支持按粒度回滚——它删得干净，但也删得莽撞。比如 ~/.cache/pip/ 下可能有正在下载的 http 临时文件，rmtree 强行删掉会导致 pip 下次报 HTTPError: 404 Client Error；又比如 /tmp/systemd-private-xxx 目录被 systemd 锁定，强制删会触发服务重启。
立即学习“Python免费学习笔记（深入）”；
- 改用逐个
unlink()+rmdir()组合：先清空目录内容，再尝试rmdir，失败则留空目录（不影响后续使用） - 对大文件（>100MB）单独加
os.remove()前 sleep(0.1)，降低 I/O 尖峰影响其他进程 - 记录失败项到
cleanup_failures.log，格式为"{path} | {errno} | {os.strerror(errno)}"，方便人工复核
真正的难点不在“怎么删”，而在“怎么证明这条路径此刻删了不会引发连锁故障”——这需要结合进程状态、文件锁、挂载信息交叉验证，而 Python 标准库只提供一半能力，剩下得靠 psutil 和 os.statvfs 补齐。
