当前位置：首页 > news >正文

一封律师函带走了 PyWxDump：微信聊天记录备份工具的上手经验与警示

news 2026/8/15 21:10:40

【免费下载链接】PyWxDump删库项目地址: https://gitcode.com/GitHub_Trending/py/PyWxDump

去年年底我换了台新电脑，才发现微信里攒了多年的聊天记录差点保不住。朋友递来一个名字：PyWxDump——一个能把微信本地聊天记录导出成普通文件的开源工具。靠着它，那些记录被整整齐齐地搬了出来。

可半年后我听说，这个项目删库了：作者收到腾讯方面的律师函，认定核心功能存在合规风险，随后清空了全部代码与提交历史。

所以这篇文章不讲套话，只聊三件事：这套工具到底怎么用、我踩过哪些坑，以及它消失前留下的那句忠告。

它到底能干什么？PyWxDump 读取微信 PC 版留在你电脑里的加密数据库，在本地完成解密，把聊天记录导出成 CSV 或 HTML。说人话：把锁在微信盒子里的记录，变成你随时能打开的普通文件。

它和微信官方备份差在哪？官方备份格式封闭，只能在微信生态里恢复；PyWxDump 导出的是通用格式——CSV 可以丢进 Excel 做统计，HTML 保留聊天排版和媒体链接，拿到任何设备都能直接看。

用它安全吗？解密和导出全部在本机完成，不上传任何数据。真正要防的是你自己：临时生成的密钥文件记得及时清理，别让它长期躺在磁盘上。

那它为什么没了？2025 年 10 月，作者收到律师函，随后删除了仓库里全部代码，只留下一份移除通知。这件事没有任何含糊的空间。

说再多不如亲手跑一遍。下面三步是一个最小闭环，假设你手头还保留着一份删库前下载的旧版本代码。

第一步，准备。让微信 PC 版保持运行并登录你要备份的账号——工具需要从运行中的进程里读取密钥，微信不启动，后面全白搭。然后安装依赖：

pip install -r requirements.txt

如果本地没有旧副本，公开仓库地址是 https://gitcode.com/GitHub_Trending/py/PyWxDump，但请注意：仓库目前只剩移除通知，能否拿到代码取决于你本地或镜像里的存档。

第二步，执行。一条命令搞定：

python main.py --mode export --format csv --output ./backup_data

它会自动扫描系统里登录过的微信账号、定位数据库、完成解密，再按联系人拆成一个个 CSV 文件。十万条消息大约四分钟，这个速度在当时算相当能打。

第三步，验证。打开 backup_data 文件夹，你会看到按联系人命名的文件。随机挑一个打开，确认文字、时间戳都在；再跑一遍--format html对比看看——HTML 版连表情和图片链接都保留，适合直接分享。这一步验证到位，才算真正闭环。

不用全学，每条都写清楚了"什么时候用得上"。

按时间窗导出 HTML——项目复盘专用。加上--start-date 2023-03-01 --end-date 2023-06-30 --contact "项目组"，只导出某段时间某个人的记录，生成带时间轴的页面，比翻聊天记录高效得多。
分批处理超大数据库——记录超过五十万条时，加--batch-size 10000分块导出，防止内存被撑爆。我就在一台 8G 内存的老笔记本上成功跑完过一次。
迁移模式——换电脑前用--mode migrate把数据打包成迁移包，新机器上再恢复，比官方"手机→电脑"的迂回路线直接得多。
定时自动备份——写个脚本，每周全量、每天增量。数据这东西，丢的时候才想起备份就晚了。