从 33GB 到 5GB：这款多线程微信清理工具，帮你安全告别缓存堆积

从 33GB 到 5GB：这款多线程微信清理工具，帮你安全告别缓存堆积

【免费下载链接】CleanMyWechat自动删除 Windows 和 Mac 电脑端微信缓存数据，包括从所有聊天中自动下载的大量文件、视频、图片等数据内容，解放你的空间。项目地址: https://gitcode.com/gh_mirrors/cl/CleanMyWechat

微信用久了，你的 C 盘还扛得住吗？我见过太多这样的场景：电脑里微信一个文件夹就吃掉 33.4GB，塞满了 106426 个小文件——绝大多数是群里自动下载的图片、视频和文件，其中很多你根本没点开过，却一年又一年地躺在磁盘里。手动清理？面对十万个文件，删到明年也删不完。CleanMyWechat 这款开源微信清理工具，正是为这个痛点而生：它自动扫描微信缓存数据、多线程并发删除、删除前先送回收站，把"清缓存"从一件苦差事变成一次点击。

为什么说它值得一试？四个必须知道的理由

• 🛡️安全第一：删除前先扫描预览、二次确认，文件先进回收站，还能自定义白名单保护重要文档
• 🧠全自动识别：自动检测电脑上的所有微信与企业微信账号，Windows 和 Mac 通吃，支持最新微信 4.0+
• ⚡多线程并发：十万个小文件的清理任务被拆成多个并行子任务，速度提升数倍，界面全程不卡顿
• ⏰甩手模式：支持定期自动清理，设置好之后，每隔一段时间它自己就把过期缓存收拾干净

这就是它的主界面：左侧一键扫描清理，右侧按账号、按文件类型精细配置清理策略

深入拆解：一个靠谱的清理工具是怎么炼成的

一款清理工具最怕什么？删错东西。CleanMyWechat 的聪明之处，在于它把"清缓存"拆成了三步：先认路、再分类、最后安全删除。下面我们从代码层面看看它每一步是怎么做的。

第一步：认路——它怎么找到你的微信数据？

微信的安装位置五花八门：老版本在Documents\WeChat Files，新 4.0 在xwechat_files，商店版藏在AppData\Local\Packages，Mac 上又变成沙盒容器目录……普通人根本记不住。

utils/selectVersion.py里的find_all_wechat_paths()像个侦探，把几十个候选路径全部扫一遍：读 Windows 注册表的FileSavePath、遍历 C 到 G 盘常见目录、探测 macOS 的沙盒容器，再用is_wechat_like_account_dir()判断"这个文件夹长得像不像微信账号目录"。

for drive in ['C', 'D', 'E', 'F', 'G']: candidates.extend([ rf'{drive}:\WeChat Files', rf'{drive}:\xwechat_files', rf'{drive}:\Users\{user}\WeChat Files', ])

一句话解释：这段代码在挨个盘符、挨个常见路径"敲门"，看哪个门里住着微信的账号数据。

为什么这么做？因为用户永远记不住自己的微信装在哪，让工具自己找路，比让用户手动指路可靠一百倍。找不到也没关系，界面里还留了"重新选择目录"的手动入口。

第二步：分类——什么该删，什么绝不能动？

找到了目录，接下来要区分"缓存垃圾"和"重要数据"。这活儿看似简单，实则充满细节：

• 图片、视频、文档按扩展名分门别类（.jpg、.mp4、.pdf……）
• 过期判断按文件最后修改时间，默认只清理 365 天之前的文件
• .db、.sqlite、.dll、.exe这类数据库和程序组件永远跳过，因为删了微信就坏了
• 白名单机制：whitelist.txt里写一行路径或扩展名，对应文件就绝不动手

SAFE_SKIP_EXTS = {'.db', '.sqlite', '.dll', '.exe', '.msi', '.sys', ...} def is_protected_file(file_path): return os.path.splitext(str(file_path))[1].lower() in PROTECTED_EXTS

一句话解释：动手之前先看"身份证"（扩展名），数据库和运行库这类危险分子一律放行。

为什么这么做？清理工具翻车通常不是删了缓存，而是误删了数据库导致聊天记录丢失。宁可少删，不能错删——这正是它敢宣称"不会删除文字聊天记录"的底气。

第三步：并发——十万个文件如何删得快？

单线程删除十万个文件有多慢？每个文件都要等系统响应、等进度条挪动，动辄几十分钟。CleanMyWechat 的解法是utils/multiDeleteThread.py里的多线程：把文件列表拆给多个线程并行处理，每个线程删完一个文件就通过信号上报进度。

class multiDeleteThread(QThread): delete_process_signal = pyqtSignal(int) def _delete_path(self, file_path): if is_protected_file(file_path): return send2trash(file_path) # 先进回收站，不直接物理删除 def _emit_progress(self): qmut.lock() self.share_thread_arr[0] += 1 self.delete_process_signal.emit(self.share_thread_arr[0]) qmut.unlock()

一句话解释：多线程各管一批文件同时删，用互斥锁保护共享进度计数，删除全部走回收站而不是物理抹除。

为什么这么做？两个关键点：一是QMutex 锁保证多个线程同时更新进度时数据不错乱；二是send2trash让所有文件先进回收站——真删错了，你还来得及反悔。这层"后悔药"设计，是它和那些一键物理删除工具最大的区别。

体验细节：清理前的"最后一道确认"

删之前，它会弹出预览对话框：预计释放多少空间、多少个文件、多少个空文件夹、按图片/视频/文档分类列出清单，还能双击路径定位文件位置。你确认后它才动手。

这可不是多此一举。清理工具的用户体验，90% 取决于"反悔成本"有多低——预览 + 回收站这套组合拳，把误删风险压到了最低。

实战上手：从安装到第一次成功清理

整个上手过程不超过五分钟，跟着下面五步走：

1. 获取代码并安装依赖

git clone https://gitcode.com/gh_mirrors/cl/CleanMyWechat cd CleanMyWechat pip install -r requirements.txt

依赖只有三个核心库：PyQt5（界面）、Send2Trash（回收站删除）、python-dateutil（时间计算），安装基本不会踩坑。

2. 启动并等待自动检测

python main.py

首次启动会自动弹出配置窗口并扫描检测微信账号。Mac 用户如果弹出权限提示，记得去"系统设置 → 隐私与安全性 → 完全磁盘访问权限"里放行。

🚧新手避坑提示：检测结果里如果出现多个账号，请逐一确认每个账号的"保留时间"和清理范围，默认 365 天已经比较保守，不建议手滑改成 0。

3. 按需调整清理范围

在设置界面勾选要清理的类型：图片缓存、视频、收到的文档、图片……还可以单独设置每个账号的保留天数。

4. 点击"扫描并清理"

它会先弹出预览清单，确认无误后点"确认清理"，多线程引擎开始工作，进度条实时更新。

5. 去回收站再检查一遍

清理完成后，所有文件都在回收站里。翻一翻有没有漏网之鱼，确认无误后清空回收站，空间正式释放。

效果说话：清理前后对比

以 readme 里展示的真实案例为例，一个使用两年的微信账号：

这就是典型的重度用户现状：一个微信文件夹 33.4GB、十万多个文件，其中绝大多数是过期缓存

再看看它与"手动删除"这种最朴素方案的差距：手动清理要逐层点开文件夹、猜哪些能删、还得小心别碰坏数据库——效率和安全性都是被碾压的。而同类工具里，能把"自动识别账号 + 多线程 + 回收站 + 白名单 + 定时清理"全做到位的开源项目，并不多见。

答疑解惑：你关心的几个问题

Q1：会删掉我的聊天记录吗？不会。文字聊天记录存放在.db/.sqlite数据库文件中，这些扩展名在代码里被硬编码进跳过名单，任何清理模式下都不碰。

Q2：清理的文件还能找回吗？能。默认所有删除都走send2trash，文件先进系统回收站，清空回收站之前随时可以恢复。如果你勾选了"直接删除"，那就真的物理抹除了，不建议默认开启。

Q3：支持 Mac 吗？支持企业微信吗？都支持。项目已适配 macOS 沙盒目录与权限申请流程，同时自动识别企业微信（WXWork）账号及其专属缓存结构。

Q4：能定时自动清理吗？能。在设置中开启"定期自动清理"并填写间隔天数（默认 30 天），配合"开机自启动"，之后基本不用管它。

Q5：担心误删重要文件怎么办？打开程序目录下的whitelist.txt，一行写一个路径或扩展名（比如.pdf、D:/重要文件），白名单里的内容永远不会被清理。

写在最后：空间自由，应该是一键的事

CleanMyWechat 的价值，不在于代码有多炫，而在于它把一件"想起来就头疼"的事，变成了一个没有心理负担的日常动作：扫描、预览、确认、完事。它适合所有被微信缓存折磨的普通人——不熟悉电脑的长辈、磁盘告急的办公党、追求极致整洁的极客，都能在五分钟内上手。

如果你是开发者，它的代码结构也值得一读：utils/selectVersion.py教你如何优雅地探测软件安装位置，utils/multiDeleteThread.py展示了一个线程安全的删除引擎该长什么样，main.py里那套"扫描 → 预览 → 确认 → 执行"的流程设计，本身就是清理类工具的教科书。

下一步，它还值得更好的方向：按账号精细统计释放报告、更聪明的缓存识别模型、甚至接入云盘自动归档……而这些，正是开源项目留给每个贡献者的想象空间。

现在，去你的回收站看看，或者直接跑一次python main.py——当 C 盘多出几十个 GB 的那一瞬间，你会回来感谢自己的。

【免费下载链接】CleanMyWechat自动删除 Windows 和 Mac 电脑端微信缓存数据，包括从所有聊天中自动下载的大量文件、视频、图片等数据内容，解放你的空间。项目地址: https://gitcode.com/gh_mirrors/cl/CleanMyWechat