Converter WeChat-Export-Tool 一键解密并导出微信聊天记录

微信电脑版里的聊天记录，想导出来存成能随时翻看的文件，官方一直没给个趁手的工具。截图太麻烦，备份文件又只能在微信里恢复。Ray0612 开发的 WeChat-Export-Tool 用了一种更直接的方式：从本地数据库入手，拿到解密密钥后把聊天记录读出来，再导出成 HTML、PDF、Excel 这些通用格式。下面从安装到实际使用，一步步拆开讲。

项目基本信息

信息项详情
项目名称WeChat-Export-Tool
GitHub地址https://github.com/Ray0612/WeChat-Export-Tool/releases
项目描述基于逆向工程开发的 Windows 微信聊天记录导出器，支持按联系人浏览、搜索并导出聊天记录，无需 root 或修改微信客户端
作者Ray0612
开源协议未明确标注
开源状态公开状态
LanguagesPython
支持平台Windows
最后更新2026-07-15（v1.2.0）

一、项目介绍

WeChat-Export-Tool 的核心思路并不复杂，但实现起来需要不少逆向工程的工作量。它针对的是 Windows 版微信 4.X 版本的本地数据库，通过捕获微信进程运行时内存中的解密密钥，把 SQLite 数据库打开，再按会话结构解析出聊天记录。

整个操作流程围绕一个图形界面展开，用户不需要碰命令行。从 v1.2.0 版本开始，工具支持导出的格式包括 HTML、PDF、TXT、JSON、CSV 和 Excel，图片也会在 HTML 和 PDF 格式中一并输出。对于需要归档或者打印聊天记录的人来说，HTML 和 PDF 是最实用的两个选项。

一个值得一提的细节是图片处理逻辑：如果某张图片你之前在微信里点开过、本地已有高清缓存，导出时就会拿到高清版本；如果从未加载过，则只能拿到缩略图。这个设计虽然不算完美，但至少给用户留了一个“先点开再导出”的补救路径。

二、核心优势

无需 root 或改客户端。工具走的是内存取密钥加本地数据库读取的路线，不对微信本体做任何修改，降低了对账号安全的风险。

多格式输出，覆盖不同用途。HTML 适合长期归档和全文搜索，Excel 和 CSV 适合做统计分析，PDF 适合打印或提交材料，JSON 则方便开发者做二次处理。同一份聊天记录可以按需要导出成不同形态。

密钥持久化，不用反复抓取。v1.2.0 加入了密钥自动记录功能，第二次打开工具时之前用过的密钥会被填充，省去每次都要关微信、重新捕获的步骤。

消息加载无硬上限。早期版本加载消息时有 2000 条的上限，v1.2.0 改成了按会话实际消息总数加载，长对话不再被截断。

三、适用场景

工作沟通归档。和客户或合作方在微信上敲定的细节、报价、时间节点，导出成 PDF 或 Excel 留底，比在聊天列表里往回翻靠谱得多。

重要对话留存。家人之间的语音转文字记录、朋友发来的地址和账号信息，导出一份放在本地硬盘里，换手机或清理微信存储时不至于丢掉。

轻量数据分析。导出 CSV 后用 Excel 做透视表，看看某个月和谁聊得最多、消息集中在什么时段。虽然不如专门的聊天分析工具强大，但胜在数据来源直接。

需要说明的是，这个工具面向的是导出自己账号的本地数据。它不涉及远程获取他人聊天记录，使用前需要微信处于登录状态且本地有数据缓存。

四、安装教程

第一步：下载

打开 Releases 页面（https://github.com/Ray0612/WeChat-Export-Tool/releases），找到最新版本 v1.2.0，下载对应的压缩包。页面上的发布物是编译好的可执行程序，不需要自己配 Python 环境。

第二步：解压

把压缩包解压到一个你方便找到的文件夹。建议不要放在桌面或下载目录里，因为工具运行时会生成工作目录和日志文件，放在一个独立文件夹里更清爽。

第三步：首次运行前的准备

确保 Windows 电脑上已经登录微信，并且你需要的聊天记录在本地存在。如果微信刚重装过、聊天记录还没同步下来，先让微信把消息拉取完整再操作。

第四步：启动工具

进入解压后的文件夹，双击 WeChatExport.exe 或 启动工具.bat。如果系统弹出 SmartScreen 提示，选择“更多信息”再点“仍要运行”。这类未签名的独立工具在 Windows 上出现提示是正常现象。

第五步：设置工作目录

在工具界面上指定一个工作目录。这个目录用来存放日志、临时文件以及最终导出的内容。建议选择一个剩余空间充足的磁盘分区。

五、使用示例

下面以导出一个联系人的聊天记录为 HTML 文件为例，走一遍完整流程。

获取密钥

在工具主界面点击“获取密钥”。工具会提示你关闭微信。按照提示关掉微信进程后，工具会自动捕获解密密钥。如果你之前导出过、工具已经记录了密钥，这一步可以直接跳过。

连接数据库

密钥就绪后，点击“连接数据库”。工具会用密钥打开微信本地的 SQLite 数据库文件。这一步如果失败，最常见的原因是微信数据库路径设置不对，或者微信版本不在支持范围内（目前主要面向微信 4.X）。

浏览会话

连接成功后点击“浏览会话”，左侧或列表中会出现联系人/群聊列表。找到你要导出的那个对话，点击即可在右侧预览最近的聊天内容，确认选对了人。

选择导出格式

在导出选项中，选择 HTML。HTML 格式的优势是生成一个包含图片子目录的独立文件夹，双击 index 文件就能在浏览器里打开，支持 Ctrl+F 搜索关键词，排版也接近微信聊天的气泡样式。

等待导出完成

点击导出后，工具会后台处理消息和图片。如果聊天记录很长、图片很多，需要等一会儿。v1.2.0 有进度窗口，界面不会卡死。导出完成后，打开工作目录里生成的文件夹，就能看到 HTML 文件了。

如果你想导出 Excel 用于统计，流程完全一样，只是在格式选项里换成 Excel 即可。注意 Excel 和 CSV 格式不包含图片，只有文本内容。

六、常见问题

获取密钥时一直失败

先确认微信已经完全退出，包括右下角托盘区的图标也要右键退出。如果还是不行，尝试以管理员身份运行工具。部分安全软件可能会拦截内存读取操作，临时关闭防护再试一次。

导出的图片是模糊的缩略图

这是已知行为。工具优先读取微信本地已加载的高清缓存，如果某张图片你在微信里从未点开过，就只能拿到缩略图。解决办法是在微信里手动点开那几张图片，让它们下载到本地，然后重新导出。

连接数据库时报错

检查微信数据库路径是否正确。微信 4.X 的数据库路径和旧版不同，工具设置里一般可以自动检测或手动指定。另外确认微信版本号，如果版本过新而工具还没适配，可能需要等作者更新。

导出后 PDF 里长文本排版错乱

v1.2.0 已经针对 PDF 长文本的截断问题做了修复，长文本会直接显示文字而不是硬塞进气泡里。如果仍有问题，尝试改用 HTML 格式，浏览器的渲染容错率更高。

七、总结

WeChat-Export-Tool 解决的是一个很具体的需求：把 Windows 微信 4.X 的本地聊天记录变成可以脱离微信打开的文件。它没有试图做一个“聊天分析平台”或者“云端备份服务”，而是老老实实做解密、读取、导出这三件事。

优点是流程清晰、格式覆盖够用、密钥持久化省事。不足也很明显：仅限 Windows、仅面向微信 4.X、图片高清导出依赖用户手动预加载。如果你需要的是一个免费、本地运行、能出 HTML 和 PDF 的导出方案，它值得放进工具箱。如果聊天记录量极大且图片多，导出过程需要一些耐心。