3 步快速完成微信聊天记录备份：PyWxDump 解密导出完整指南

3 步快速完成微信聊天记录备份：PyWxDump 解密导出完整指南

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

PyWxDump 是一款基于 Python 的命令行工具，定位非常单一：微信聊天记录备份。它从正在运行的微信进程里取出解密密钥，把本机以密文状态存放的聊天数据库整体还原成明文，再导出为 HTML 归档文件，专治「记录还锁在旧设备里、微信又没给导出入口」这一类麻烦。

微信聊天记录备份能解决什么问题

最常见的触发场景是设备更换：公司统一换新笔记本、旧机交还 IT 做格式化；家里那台台式机硬盘告急，腾空间之前想先把几年积累的工作群记录留住。微信客户端自身没有提供任何导出按钮，聊天记录以加密数据库的形式躺在本机，直接拷贝这些文件根本打不开。PyWxDump 走的是一条「取密钥 → 解密 → 导出」的路径，正常情况下几分钟内就能拿到一份可长期保存的结构化记录。

备份前置条件：环境、权限与数据安全

1. 搭好 Python 环境，装上依赖

git clone https://gitcode.com/GitHub_Trending/py/PyWxDump cd PyWxDump pip install -r requirements.txt

2. 微信必须处于登录且在运行的状态。解密密钥只存在于微信进程的内存里，进程一结束，密钥随之作废，这是整个流程的硬前提。

3. 终端拿够权限。读取别的进程内存，在 Windows 上需要管理员身份，Linux / macOS 则要有对应的读取权限。

⚠️ 开跑之前还有一步不能省：先把微信数据目录整个拷贝一份留底。后续操作理论上都是只读的，但手上有原始副本，心里才真正踏实。

🔑 主流程：bias / decrypt / export 三条命令

bias：从进程内存取出密钥

python -m pywxdump bias --auto

密钥好比直播间密码，只有进程「开播」时才拿得到。--auto会依次完成定位进程、锁定关键组件、内存扫描、参数计算四步，顺利的话密钥会写入本地缓存，供下个环节直接取用。

decrypt：批量解密本地数据库

python -m pywxdump decrypt --all

拿刚才取到的密钥，把微信数据目录里的加密文件逐个还原成可读内容。有文件解密失败时，多半是版本兼容问题，先别慌，参考下一节排障。

export：生成 HTML 归档

python -m pywxdump export --format html

产物是一个直接用浏览器就能打开的 HTML 文件，聊天与附件都按结构排好，适合归档、也方便日后随时翻阅。

🩺 排障手册：密钥提取失败与导出不完整的处理

• 现象：跑完bias没有任何有用输出。原因：微信未登录、进程未驻留，或终端权限不足。处理：确认微信已登录并处于前台运行，换管理员终端重跑；仍无结果就上python -m pywxdump bias --force跳过缓存重算；还不行再上--deep深度扫描（更慢，覆盖范围更广）。
• 现象：个别文件解密报错。原因：当前微信版本不在支持范围内。处理：执行python -m pywxdump check --version核对兼容性；命中兼容问题的话，用--force重新提取密钥再解密。
• 现象：导出中断，文件不完整。原因：过程中微信被关掉了，或者系统进入休眠。处理：让微信在整个导出期间稳定运行，然后重跑一次导出命令。

进阶用法：多账号、按人筛选与离线恢复

• 微信已经退出、机器环境变了：原始数据文件还在的话，静态恢复这条路就还有得走：

python -m pywxdump recover --path "微信数据目录路径"

• 同一台机器登录了多个账号：先列出全部被检测到的账号，再挑要处理的那个，工作号和生活号各归各：

python -m pywxdump bias --multi

• 只想留特定的人、特定的时间段：按联系人和时间范围做精细导出：

python -m pywxdump export --contact "张三" --date "2024-01-01:2024-12-31"

合规边界与动手前检查清单

⚠️ 把话说清楚：「读进程内存取密钥 + 解密数据库」这条技术路线长期伴随合规争议，项目方已因此收到微信方面律师函，代码仓库也随之撤下（详见 README.md，函件见下图）。使用时请守住底线：只导出自己账号、自己设备上的数据；导出记录与原始数据同属个人隐私，存放和分享都要同样谨慎。

动手前逐项核对：

• 微信处于登录运行状态，终端以管理员身份打开
• 微信数据目录已完整拷贝一份
• bias命令正常输出密钥信息
• 解密导出后打开 HTML，抽查过内容完整可读
• 归档文件放在私人且安全的位置

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