4步把微信PC端聊天记录解析成网页:PyWxDump用法一次讲透
【免费下载链接】PyWxDump删库项目地址: https://gitcode.com/GitHub_Trending/py/PyWxDump
你翻到三年前的一条微信消息,想把它连同上下文一起存档,却发现微信PC端的聊天记录锁在加密数据库里,双击也打不开。PyWxDump 就是干这个的:解析微信PC端本地数据,算出数据库密钥,把聊天记录导出成浏览器里能直接翻的HTML网页。
环境与安装
先对一下要求,缺哪项都会在对应环节卡住:
| 项目 | 要求 |
|---|---|
| 系统 | Windows 7 及以上 |
| Python | 3.7 或更高版本 |
| 微信 | 3.2.1.154 ~ 3.9.12.55 |
| 运行权限 | 管理员 |
安装只要两条命令:
git clone https://gitcode.com/GitHub_Trending/py/PyWxDump # 拉取项目源码 cd PyWxDump # 进入目录,后面所有操作都在这里做跑完后你会得到一份项目源码目录,下一步就是运行主程序。
⚠️ 有个现状得先说:2025年10月,原作者收到律师函后删除了仓库里的全部代码,现在 clone 下来只剩移除说明,详见 README.md。下面讲的是该项目历史版本的操作方式。
按目的拆操作
拿到账号的完整身份信息
- 以管理员身份打开命令窗口,进入项目目录运行主程序(程序要读取内存里的密钥,权限不够会失败)。
- 等它扫描本机安装的微信,确认版本号在支持范围内。
- 看控制台输出,不用自己翻数据库文件。
做完后你会看到:昵称、微信号、wxid、绑定手机号和邮箱,以及这个账号数据库对应的解密密钥。
💡 电脑上登录过多个微信时,程序会逐个列出账号,挑你要处理的那个继续就行。
把加密数据库读出来
- 保持微信处于登录状态(密钥在登录态的进程里,退出登录就读不到了)。
- 执行解密流程,程序自动识别加密方式并计算密钥,多个数据库文件会依次处理。
- 对输出做完整性校验,确认没有解坏的字段。
做完后你会得到一组解密后的数据库文件,结构和解密前一致,可以用数据库工具直接打开查看。
把聊天记录变成可翻阅的网页
- 选定要导出的会话范围。
- 执行导出,程序按原始时间顺序把文字、图片、语音一起转成HTML。
- 用浏览器打开生成的页面。
做完后你会看到按时间一条条排开的对话,图片能点开看原图,语音有对应的媒体文件。
导出结果怎么看
导出目录通常是这样的:按会话分成若干HTML文件,旁边一个子目录存图片和语音,文件名里带会话名和时间段,方便对照。
想缩小范围?把配置文件里的会话过滤字段(如contact)改成对方 wxid——wxid 在"拿到身份信息"那一步已经查到了——再跑一次导出即可。
找具体某条消息时,先按会话名定位HTML文件,再用浏览器的 Ctrl+F 搜关键词,比翻整个目录省事得多。
踩坑速查
| 现象 | 原因 | 解法 |
|---|---|---|
| 程序不认当前微信版本 | 版本超出 3.2.1.154 ~ 3.9.12.55 范围 | 先把 PyWxDump 更新到最新版,仍不行就换支持范围内的微信 |
| 解密失败、提示取不到密钥 | 微信没登录,或没用管理员权限运行 | 登录微信后,用管理员身份重新跑一遍 |
| 网页里图片显示不出来 | 导出时媒体文件路径没对齐 | 别移动微信安装目录,重新导出一次 |
以上都排过了还不行,去项目Issue区搜一下版本号。
进阶两招
多账号一次跑完:适合电脑上轮流登录多个微信的人。扫描时保留全部账号,按列表顺序逐个解密、导出,中途不要切换微信登录。跑完你会得到按账号分开的几组网页,内容互不串。
只导出指定会话:适合只想留某几个重要会话、不想全量搬的人。把配置里的contact字段改成目标 wxid,再执行导出。目录里只剩这一个会话的HTML和媒体文件,体积小,查找也快。
使用边界
这套操作只用来备份和分析你自己账号的数据,别碰别人的聊天记录;同时遵守当地法规,涉及他人隐私的内容不要外传。
另外提醒一句:项目本身在 2025 年 10 月已随律师函下架,下面是当时的律师函原文。旧版本副本是否继续使用,风险请自行评估。
【免费下载链接】PyWxDump删库项目地址: https://gitcode.com/GitHub_Trending/py/PyWxDump
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考