先别急着找清理软件。上个月我正跑着 docker build系统突然弹了个 no space left on device构建直接失败再一看 C 盘只剩 800MB。挨个翻目录才发现系统临时文件、Windows 更新缓存、WER 日志、各种开发工具的缓存零零碎碎加起来快 30GB。从那天起我决定给自己写一个临时文件自动化工具。这个工具做的事情很明确自动扫描并删除系统临时文件、Windows 更新缓存、软件日志、无效缓存和回收站冗余文件同时牢牢守住个人文档、照片、安装软件这些真正重要的数据清理结束后把释放了多少空间列成清单给你。它适合程序员的开发机、运维手上长期不重启的服务器也适合任何觉得 C 盘突然不够用的普通用户前提是你愿意看明白脚本做了什么。下面就是我这次做的完整记录包含设计思路、核心代码、计划任务接入方式以及一些只有踩过坑才会知道的细节。1. 需求拆解与整体设计思路1.1 磁盘空间都去哪了一份开发者视角的“垃圾地图”大多数开发者对自己 C 盘空间被什么吃掉其实是没概念的。你以为装了几个大型软件就没了实际上真正的大头往往是散落在各个角落的临时文件和缓存。我把一台用了两年的开发机翻了一遍典型的东西有这么几类目录里面是什么典型大小能不能清%TEMP%用户临时目录编辑器临时文件、安装包解压残留、各类程序运行中间产物2GB ~ 10GB能按时间过滤后删C:\Windows\Temp系统级临时文件部分旧安装程序的残留1GB ~ 5GB能部分需管理员权限C:\Windows\SoftwareDistribution\DownloadWindows 更新下载缓存安装完就没用了1GB ~ 8GB能直接删内容C:\ProgramData\Microsoft\Windows\WERWindows 错误报告、崩溃转储几百MB ~ 2GB能基本都是无用日志%LOCALAPPDATA%\Microsoft\Windows\INetCacheIE/Edge 传统缓存1GB ~ 4GB能各种开发者工具缓存微信开发者工具编译缓存、VS Code 缓存、Chrome 缓存、npm/pip 缓存5GB ~ 20GB需要甄别不能一刀切这里我特别想提一下开发者工具。微信开发者工具默认缓存路径在%LOCALAPPDATA%\微信开发者工具下一次完整的小程序项目调试就能积累上 G 的编译缓存Chrome DevTools 用久了CacheStorage、Code Cache这些目录也会悄悄膨胀。很多同类清理软件根本不知道这些目录的存在或者不敢动它们所以清理效果非常有限。这也是我决定自己写工具的核心原因开发者机器的垃圾只有开发者自己最清楚。1.2 工具的功能边界哪些该删哪些打死都不能碰这个工具的安全底线非常明确个人文档、照片、视频、音乐、已安装软件的可执行文件和配置、正在使用的工程文件一律不在扫描范围之内。为了实现这个底线我定了规矩只清“显式列入清单”的目录不做全盘搜索式清理。全盘扫*.tmp看起来很厉害但 Photoshop 的暂存文件、IDE 的 autosave、数据库的临时表空间都可能混在里面删掉就是事故。所有目标目录都走白名单机制路径必须能被明确枚举到不在清单里的路径即使看起来像垃圾也宁可不删。凡是位于“个人数据区”桌面、文档、图片、下载、音乐、视频下的内容默认被排除。哪怕这些目录里有一个.tmp文件也不删因为那可能是你刚下载到一半的资料。删除操作必须满足“修改时间超过 N 天”的门槛默认 7 天。正在活跃使用的文件会自动被年龄条件挡在门外。这个边界的本质是用“位置 特征 时间”三个过滤器做交集而不是拿一把大刀把所有看起来像垃圾的东西都砍了。宁可漏掉一些可以删的文件也不误删任何一个可能的有效数据。1.3 为什么我不直接用现成清理软件市面上清理软件很多我一个都没用不是觉得它们没用而是有三个绕不过去的问题。第一是黑盒。大部分清理工具扫出来的“垃圾”列表不会告诉你每个文件具体是什么、属于哪个软件、删了之后会有什么连锁反应。遇到开发者目录它们要么不认识直接漏掉要么当成普通缓存给你清了但 npm cache 其实可以靠官方命令安全清理直接删目录也没问题可有些软件的自定义模板目录如果被误删下次打开直接回到出厂状态。黑盒操作不能让我放心。第二是隐私。让我把自己的整体文档目录交给一个第三方软件扫描我是不愿意的。它可能很规矩但没必要冒这个险。第三是无法自动化、无法审计。定时清理、输出结构化报告、和运维监控对接这些需求在现成软件里基本都不好实现。自己做一个小脚本所有行为都在代码里任何人审一遍就知道它删了什么这比任何宣传文案都可靠。就这样需求变清晰了一个用 Python 写的、白名单机制、带 dry-run 预览、能生成报告的临时文件自动化工具。2. 核心技术与方案选型2.1 用 Python 而不是批处理安全性和可维护性更重要网上能搜到一堆win11删除临时文件bat的脚本几行del /s /q就能把指定目录清了看起来简单粗暴。坦白讲我最早的第一版就是这个思路但用了两周就放弃了。原因是批处理在“安全校验”和“统计反馈”上实在太弱没有安全的路径校验del /s配合一个变量不小心拼错的路径可能把不该删的目录扫进去。没有文件年龄过滤做不到“只删 7 天前的文件”。没有结构化统计删完了你不知道释放了多少、失败了几个。跨平台、扩展、写单元测试都很别扭。Python 只需要标准库就能覆盖全部需求pathlib处理路径、os做遍历、shutil处理清理、argparse接收参数、json导出报告。再加上 Python 3.8 以上几乎是现代开发机的标配不引入任何第三方依赖把.py文件丢进去就能跑。最终我的方案是“Bat 做壳Python 做核”一个 5 行的.bat文件负责被任务计划程序调用真正逻辑全部放在 Python 脚本里。这样既能在 Windows 下无感启动又能保住安全校验和统计报告能力。2.2 三层过滤器位置、特征、时间工具的安全性核心在三层过滤器缺一不可位置过滤器。要清理什么全在CLEAN_TARGETS字典里列清楚。脚本遍历时不会跳出这些目录每个被处理的文件最终解析出来的绝对路径必须仍然位于允许清理的目标目录之下。同样重要的还有PROTECTED_DIRS保护名单扫描过程中一旦发现路径落在保护名单里立即跳过。特征过滤器。在指定的缓存目录中不区分扩展名直接按年龄删是可以的但在偏杂乱的临时目录里我会额外跳过一些明显有“活”特征的目录名比如node_modules、.git、ServiceWorker避免正在用的工具链被打断。当然也可以不跳但对我这种经常做前端构建的人来说把这些目录从清理范围里拿走能少很多麻烦。时间过滤器。这一点最关键。代码里用st_mtime判断最后修改时间只有超过min_age_days默认 7 天的文件才会进入删除候选。这能自动挡住绝大多数正在使用的文件因为活跃文件通常都会被频繁修改。如果有人坚持要当天清理也可以用--min-age 0强制放行但我不建议你这么做除非你刚刚关掉了所有可能占用临时文件的程序。三层过滤器叠在一起才真正把“保留个人文档、照片、安装软件等重要数据”从口号变成了工程实现。2.3 清理报告让每次操作都留下可审计的痕迹自动化工具和手动删除最大的区别是它必须可追溯。所以我的脚本在“删除前”和“删除后”都会做统计清理前计算每个目标目录下有多少文件符合条件、体积多大。清理中记录成功删除了多少文件、释放了多少字节、因占用或权限失败的有哪些。清理后按目录汇总输出一张表格并可选择导出 JSON 报告。JSON 报告很实用我后来把它接到了日志系统里每周自动清理完就能看到磁盘“健康状态”的变化曲线。如果清理出现大量失败文件也可以从报告里定位到具体路径排查是哪个进程在占用。3. 从零实现一个可落地的清理工具3.1 先摸底把目标目录的大小量化出来写工具第一步不是写删除逻辑而是先摸清自己机器上这些目录到底有多大。我直接用一段几行的 Python 脚本把候选目录都统计了一遍import os from pathlib import Path candidates [ Path(os.environ.get(TEMP, rC:\Windows\Temp)), Path(rC:\Windows\Temp), Path(rC:\Windows\SoftwareDistribution\Download), Path(rC:\ProgramData\Microsoft\Windows\WER), ] def dir_size(path): total 0 for base, _, files in os.walk(path): for name in files: fp Path(base) / name try: total fp.stat().st_size except OSError: pass return total for p in candidates: if p.exists(): print(f{p}: {dir_size(p) / 1024 / 1024:.2f} MB)这一步强烈建议做一下。很多开发者以为自己的空间被微信开发者工具缓存吃了一跑统计发现其实是 Windows 更新缓存占了大头。先搞清楚问题在哪再决定清理范围效果完全不同。3.2 核心实现扫描、统计、删除、报告一条龙下面这份脚本是我的简化版完整保留了安全设计和报告逻辑。你可以直接存成clean_temp.py使用。#!/usr/bin/env python3 # -*- coding: utf-8 -*- import argparse import json import os import subprocess import time from pathlib import Path # ---------- 配置区按需修改 ---------- TEMP_DIRS [ Path(os.environ.get(TEMP, rC:\Windows\Temp)), Path(rC:\Windows\Temp), ] UPDATE_DIRS [ Path(rC:\Windows\SoftwareDistribution\Download), ] LOG_DIRS [ Path(rC:\ProgramData\Microsoft\Windows\WER), ] BROWSER_CACHE_DIRS [ Path(os.environ.get(LOCALAPPDATA, rC:\Users\Default\AppData\Local)) / Microsoft / Windows / INetCache, ] CLEAN_TARGETS { 系统临时文件: TEMP_DIRS, Windows更新缓存: UPDATE_DIRS, 软件日志: LOG_DIRS, 浏览器缓存: BROWSER_CACHE_DIRS, } PROTECTED_DIRS [ Path(os.environ.get(USERPROFILE, rC:\Users\Default)) / Desktop, Path(os.environ.get(USERPROFILE, rC:\Users\Default)) / Documents, Path(os.environ.get(USERPROFILE, rC:\Users\Default)) / Downloads, Path(os.environ.get(USERPROFILE, rC:\Users\Default)) / Pictures, Path(os.environ.get(USERPROFILE, rC:\Users\Default)) / Music, Path(os.environ.get(USERPROFILE, rC:\Users\Default)) / Videos, ] SKIP_NAMES {node_modules, .git, ServiceWorker, TempState} MIN_AGE_DAYS 7 # ---------- 工具函数 ---------- def is_protected(path: Path) - bool: p path.resolve() for base in PROTECTED_DIRS: try: p.relative_to(base.resolve()) return True except ValueError: continue return False def is_old_enough(path: Path, min_age_days: int) - bool: try: mtime path.stat().st_mtime except OSError: return False return (time.time() - mtime) min_age_days * 86400 def clean_dir(root: Path, min_age_days: int, dry_run: bool False): 递归清理目录内符合条件的文件不会删除 root 本身。 stats {deleted: 0, bytes_freed: 0, failed: 0, skipped: 0} if not root.exists(): return stats try: for item in root.iterdir(): if item.name in SKIP_NAMES: stats[skipped] 1 continue if is_protected(item): stats[skipped] 1 continue if item.is_dir(): sub_stats clean_dir(item, min_age_days, dry_run) for k in stats: stats[k] sub_stats[k] elif item.is_file() or item.is_symlink(): if not is_old_enough(item, min_age_days): stats[skipped] 1 continue try: size item.stat().st_size except OSError: size 0 if dry_run: stats[deleted] 1 stats[bytes_freed] size continue try: item.unlink() stats[deleted] 1 stats[bytes_freed] size except (PermissionError, OSError): stats[failed] 1 except (PermissionError, OSError): stats[failed] 1 return stats def clear_recycle_bin() - bool: try: subprocess.run( [powershell, -NoProfile, -Command, Clear-RecycleBin -Force -ErrorAction SilentlyContinue], checkFalse, capture_outputTrue, timeout60, ) return True except Exception: return False # ---------- 主流程 ---------- def main(): parser argparse.ArgumentParser(description开发者临时文件自动化清理工具) parser.add_argument(--dry-run, actionstore_true, help只统计不删除) parser.add_argument(--yes, actionstore_true, help跳过二次确认) parser.add_argument(--min-age, typeint, defaultMIN_AGE_DAYS, help只删修改时间超过该天数的文件) parser.add_argument(--recycle-bin, actionstore_true, help同时清空回收站) parser.add_argument(--json-report, typestr, help导出 JSON 报告到指定文件) args parser.parse_args() total_deleted total_freed total_failed 0 report [] print(f运行模式: {只预览(dry-run) if args.dry_run else 正式清理}) print(f年龄门槛: 修改时间超过 {args.min_age} 天的文件\n) for category, dirs in CLEAN_TARGETS.items(): for d in dirs: if not d.exists(): continue stats clean_dir(d, args.min_age, dry_runargs.dry_run) freed_mb stats[bytes_freed] / 1024 / 1024 print(f[{category}] {d}) print(f 可删/已删 {stats[deleted]} 个文件释放 {freed_mb:.2f} MB f跳过 {stats[skipped]} 个失败 {stats[failed]} 个) total_deleted stats[deleted] total_freed stats[bytes_freed] total_failed stats[failed] report.append({ category: category, dir: str(d), deleted: stats[deleted], bytes_freed: stats[bytes_freed], failed: stats[failed], }) if args.recycle_bin: if not args.dry_run: ok clear_recycle_bin() print(f回收站清理: {成功 if ok else 失败或为空}) else: print(回收站清理: 已跳过(dry-run模式)) if not args.dry_run and not args.yes: confirm input(确认执行上面列出文件的删除操作? 输入 yes 继续: ) if confirm.strip().lower() ! yes: print(已取消) return print(f\n清理结果: {total_deleted} 个文件共释放 {total_freed / 1024 / 1024:.2f} MB f失败 {total_failed} 个) if args.json_report: with open(args.json_report, w, encodingutf-8) as f: json.dump({total_deleted: total_deleted, total_freed: total_freed, items: report}, f, ensure_asciiFalse, indent2) if __name__ __main__: main()这个脚本有几个设计细节需要解释一下。clean_dir是递归处理目录内子项的但不会删除root本身。对C:\Windows\SoftwareDistribution\Download这样的目录我们只清理它里面的东西目录结构保留避免因为某个服务还在引用目录句柄导致清理失败或后续异常。另外我没有急着删除空目录因为空目录不占空间留着也不会影响后续使用还能减少一些软件重新创建目录的麻烦。SKIP_NAMES里我放了node_modules和.git。虽然理论上它们出现在这些临时目录里的可能性很低但一旦出现基本都是开发中的工作产物不该由清理工具顺手带走。这个集合可以根据个人需求增减比如你不想保留某类浏览器插件缓存也可以在这里加名字反过来如果你确认某个目录里全是垃圾也可以把它从集合中移除。回收站清理用的是 PowerShell 的Clear-RecycleBin在 Python 里通过subprocess调用。我特意加了-ErrorAction SilentlyContinue这样即使回收站为空也不会报错打断执行。注意这个功能默认是关闭的只有显式传--recycle-bin才会执行原因后面会细说。3.3 首次运行先 dry-run再正式清理我第一次跑这个工具用的命令是python clean_temp.py --dry-run --min-age 7输出大概长这样运行模式: 只预览(dry-run) 年龄门槛: 修改时间超过 7 天的文件 [系统临时文件] C:\Users\admin\AppData\Local\Temp 可删 3845 个文件释放 1234.56 MB跳过 128 个失败 0 个 [Windows更新缓存] C:\Windows\SoftwareDistribution\Download 可删 42 个文件释放 1876.21 MB跳过 0 个失败 0 个 [软件日志] C:\ProgramData\Microsoft\Windows\WER 可删 156 个文件释放 342.10 MB跳过 5 个失败 0 个 [浏览器缓存] C:\Users\admin\AppData\Local\Microsoft\Windows\INetCache 可删 890 个文件释放 210.43 MB跳过 76 个失败 0 个 清理结果: 4933 个文件共释放 3663.30 MB失败 0 个这时候其实什么都还没删列出的都是“符合删除条件”的文件。我建议第一次使用一定把这个流程走一遍先看清楚哪些目录贡献最大、哪些文件会被选中心里有数之后再用--yes去执行正式清理。这种“先预览后执行”的思路同样适合接进自动化流程每天跑一次预览并把结果存日志只有磁盘超过某个阈值时才触发真正的清理调度上会更安全。3.4 接入计划任务实现真正的无人值守自动化脚本有了接下来就是接入 Windows 任务计划程序。我用一个 5 行的批处理文件做壳把 Python 的调用和日志重定向都封装起来。run_cleaner.bat内容如下echo off cd /d C:\tools\ python clean_temp.py --yes --min-age 7 --json-report C:\tools\clean_report.json C:\tools\clean_history.log 21注意--json-report每次会覆盖同一个文件如果你要保留历史记录可以在 Python 里给文件名拼上日期比如report_20250101.json。然后用schtasks注册每周任务schtasks /Create /TN DevTempCleaner /TR C:\tools\run_cleaner.bat /SC WEEKLY /D SUNDAY /ST 03:00 /RU SYSTEM /RL HIGHEST /F这里有几个点需要重点说明。第一任务跑在凌晨 3 点是因为这个时间开发机大概率没有人在用被占用的文件最少清理成功率最高。我试过在下午 4 点跑结果一半以上的文件都因为被 IDE、浏览器、更新服务占用而失败体验很差。第二/RU SYSTEM意味着以系统权限运行能拿到比管理员更高的权限可以清理更多系统目录。伴随高权限的是更高风险所以我在任务计划里先跑了两周 dry-run确认输出无误后才改成正式清理模式。第三日志重定向很重要。 C:\tools\clean_history.log会把每次运行的结果追加到同一个日志文件一旦之后发现磁盘异常可以回查这个日志定位问题。4. 常见问题与排查技巧实录4.1 文件被占用删不掉怎么办走进度条的时候最烦的就是一串PermissionError清理结果里显示一堆“失败”。我遇到的情况分三类微信开发者工具或 VS Code 开着相关的临时文件还在被进程盯住。Windows 更新服务正在后台下载或安装SoftwareDistribution\Download目录里的文件被锁。浏览器没关干净INetCache里的部分缓存文件被后台进程占用。我的处理方法是不硬删先跳过等进程结束再补一轮。具体到脚本里失败的文件会记录在 JSON 报告里。之后如果想专门补删可以用 Process Explorer 搜索文件路径对应的句柄关掉占用的进程后单独对那个目录再跑一次清理。另外早晨刚开机的时候跑清理成功率最高。因为启动项还没全部加载更新服务也还没进入工作状态。4.2 误删风险三层保险千万别省清理工具最重要的不是效率是安全。我建议所有人在正式自动化之前把这三层保险都做满一层保险位置白名单 PROTECTED_DIRS。这已经在代码里强制实现不需要你操作但你要自己审一遍配置确认保护目录覆盖了你所有重要的文件夹。二层保险年龄过滤。默认 7 天是经验值。对于临时目录来说7 天没有动过的文件基本可以确定不会再用了。三层保险先用 dry-run 观察。连续跑两轮 dry-run看输出结果有没有出现你眼熟的路径确认没有异常再加--yes。我早期第一版脚本没有做年龄过滤结果把 IDE 正在写的一个 autosave 临时文件删了虽然当时功能没崩溃但丢失了几次撤销记录从那以后我把年龄过滤写死成了默认值。这种教训遇到一次就够了。4.3 清理后空间没有明显释放问题出在哪有段时间我清理完发现只释放了 2GB但磁盘可用空间没怎么涨排查下来有三个原因最典型。第一个原因是正在运行的进程持有文件大量文件被跳过计划任务里可以看到failed数量居高不下。解决办法前面说过调整运行时间或者分批清理。第二个原因是磁盘空间的大头根本不是临时文件而是休眠文件hiberfil.sys和虚拟内存pagefile.sys。这两个文件动辄 4GB 到 16GB不属于临时文件我的工具不会碰它们。如果你确认不依赖休眠功能在管理员命令行执行powercfg /h off可以直接关闭休眠并回收对应空间虚拟内存则建议保持系统管理不要轻易动。第三个原因是开发环境自带的巨型缓存比如node_modules、npm cache、Docker 镜像。这些应该用各自的官方命令处理而不是靠临时文件工具npm cache clean --force、pnpm store prune、docker system prune -a。我的脚本特意把这些目录放进SKIP_NAMES就是防止开发者乱删导致构建环境损坏。4.4 权限不足与“管理员模式”的正确打开方式普通用户权限跑这个脚本能清理掉%TEMP%下绝大多数文件和大部分浏览器缓存但在C:\Windows\Temp、SoftwareDistribution\Download目录会遇到权限拒绝。两个解决路径直接右键以管理员身份运行run_cleaner.bat适合手动清理。用前面schtasks创建/RU SYSTEM的计划任务适合无人值守。我个人的建议是开发机上日常清理用普通权限就够了系统临时目录和更新缓存可以留到固定维护时间用管理员权限跑一次。频繁用 SYSTEM 权限跑清理脚本万一脚本有 bug权限越高坏的影响越大。最后再分享两个小技巧这个脚本我实际用了快两个月稳定性不错。我最常用的是以下两个扩展思路供你参考。第一JSON 报告可以接进自己的监控或日志系统。每周任务跑完把clean_report.json里的total_freed字段提取出来你就能看到磁盘空间释放的历史趋势如果某周释放量突然大幅下降往往意味着有些进程异常占用文件值得去检查。第二把 dry-run 变成日常“健康巡检”。我在周日凌晨的计划任务里跑了两个任务一个--dry-run输出报告但不删一个--yes在 dry-run 成功后才执行正式清理。这样即使脚本配置将来被改动自动化流程里也永远有一道预览闸门挡在前面。让自己的清理工具先憋一周再用一周你会发现“自动化”不是越快越好而是越稳越好。