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

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把数据打包成迁移包，新机器上再恢复，比官方"手机→电脑"的迂回路线直接得多。
定时自动备份——写个脚本，每周全量、每天增量。数据这东西，丢的时候才想起备份就晚了。

第一次跑导出，程序直接报"解密失败"😅，我以为是工具坏了，折腾了半小时才发现：微信没开。密钥要从运行中的进程里读，微信不运行，一切免谈。后来我养成了习惯——先确认微信登录，再启动导出。

还有一次，导出的 HTML 里图片全裂。不是工具的锅，是媒体目录和 HTML 的相对路径对不上，文件权限也没给够。把两者放在同一层级，问题立刻消失。

最防不胜防的是版本问题：新版本微信一升级，旧工具立刻认不出数据库结构。这类工具和微信版本深度绑定，升级微信前，先确认导出任务已经跑完。

但这些技术坑都好说。真正让我警醒的，是项目本身踩的那个大坑——一个游走在灰色地带的工具，哪怕代码再优秀、用户再多，也可能在一夜之间清零。

移除通知里有一句话我一直记得：

"为了彻底规避法律问题，并本着对开源社区负责任的态度，我决定移除本项目的全部代码与提交历史记录。"

一个曾经被无数人收藏的工具，就这样退场了。

PyWxDump 的代码已经不在了，但它留下了两样东西：一是"聊天记录这种资产，真的该定期导出到自己手里"的经验；二是"工具的价值与边界同样重要"的教训——越界的工具再顺手，也可能随时消失。

如果你想继续深挖，仓库里那份移除通知和律师函图片还在，值得打开看看，那是一个开源项目最真实的一课。如果你手头留有旧版本副本，请谨慎评估使用风险后再决定是否运行。

最后给你两个小建议：把上面三条命令存进备忘录，当作你的"换机逃生手册"；再把备份写进月度清单。愿你永远用不上它，也愿你哪天需要时，还记得这几行命令。

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

建站实战干货