WeChatExporter 使用指南：免费开源，三步完成微信聊天记录导出与永久备份

【免费下载链接】WeChatExporter一个可以快速导出、查看你的微信聊天记录的工具项目地址: https://gitcode.com/gh_mirrors/wec/WeChatExporter

你有没有想过，如果手机突然黑屏、进水或者被偷，那些攒了好几年的微信聊天记录会怎样？我有个朋友就经历过——他女儿从出生到上小学的照片、语音、视频，全锁在一台再也开不了机的 iPhone 里。微信官方没有完整的导出功能，第三方恢复又贵又不可靠，那一刻他才意识到，聊天记录从来不是"存着就安全"，而是"备份了才安全"。如果你也有同样的隐忧，今天介绍的这款完全免费的开源工具 WeChatExporter，正是为微信聊天记录导出与永久备份而生的。

先看成果：跑通之后你能得到什么

先说结果，免得你觉得我在画饼。WeChatExporter 装好后，你会同时拥有两个东西：

• 一个桌面分析工具：左侧列出设备上登录过的所有微信账号，点开账号，下方是按消息量排序的聊天对象列表，右侧实时预览最近 10 条聊天内容，确认无误后再导出；
• 一个可永久保存的 HTML 聊天包：导出完成后得到一个文件夹，内含index.html、css/、js/、imgs/、audios/、data/，双击index.html就能像翻聊天软件一样浏览全部对话，图片原图保留，语音自动转码可播放。


整个过程中无需越狱手机，工具直接读取备份文件里的微信数据库，数据全程在本地处理，不经过任何第三方服务器。

定位速览：它能做什么

• 📱无需越狱：直接解析 iTunes 备份中的微信数据库，不碰手机系统
• 💬四类消息全覆盖：文字、图片、语音、视频，原样保留
• 🗓️时间范围自由筛选：只导出某段时间的对话，按需取用
• 🖥️结果本地可查：HTML 聊天包离线可看，永久保存
• 🔓完全开源免费：Node.js + AngularJS 构建，代码全部公开

快速上手：最短路径跑通

整个过程就三步：准备数据 → 安装工具 → 选择对话生成导出。照着做，半小时内能出结果。

第一步：拿到微信备份数据

1. 将 iPhone 连接到 Mac，用 iTunes 做一次完整备份。⚠️关键：务必取消勾选"加密本地备份"，否则 WeChatExporter 读不了加密的数据文件。
2. 用 iMazing 之类的备份查看工具打开刚做的备份，找到微信 App 对应的Documents 文件夹，整体导出到本地任意目录。


第二步：安装与配置工具

# 1. 克隆项目仓库 git clone https://gitcode.com/gh_mirrors/wec/WeChatExporter # 2. 进入开发目录 cd WeChatExporter/development # 3. 安装依赖 npm install

接下来是新手最容易卡住的一步：sqlite3模块需要按 NW.js 版本重新编译。别急，项目在development/framework/下已经预编译好了两个版本的node_sqlite3.node（分别对应 nwjs 0.32.1 与 0.40.1），直接拷贝即可，跳过痛苦的编译过程：

# 以 nwjs 0.40.1 为例，拷贝预编译模块 cp framework/node-webkit-v0.40.1-darwin-x64/node_sqlite3.node node_modules/sqlite3/lib/binding/

最后用 NW.js 启动（需先到 nwjs 官网下载对应版本的 NW.js）：

# 启动导出工具 /path/to/nw/nwjs.app/Contents/MacOS/nwjs .

第三步：选择对话，一键生成

1. 点击「开始原始数据分析」，选中第一步导出的 Documents 文件夹，等待解析完成；
2. 左上角选择微信账号，左下角点选聊天对象——默认只显示消息总数超过 100 条的好友或群聊，聊天少的对话不会出现在列表里，这是正常的；
3. 右侧确认最近 10 条聊天内容无误后，点击「下一步」；
4. 填写数据导出目录和日期区间（留空表示全部导出），点击「开始生成数据」，稍等片刻即得到完整的 HTML 聊天包。

之后想看记录，回到主页点「显示聊天记录」，输入刚才的导出目录即可，秒开，无需重新解析。

场景化进阶：三种典型用法

场景一：家庭回忆的定期备份 📅

建议每季度做一次完整备份。导出时在日期区间里填上起止时间（如2025-01-01~2025-03-31），只导出最近三个月的对话，既能控制生成体积，也让每次备份都有明确的"记忆切片"，多年后按年份回查非常方便。

场景二：工作项目归档 💼

做项目复盘或离职交接时，你往往只需要某个客户或某个群聊的记录。此时不必全量导出——在聊天列表里只勾选目标对话，单独生成导出包，配上项目名命名文件夹，就形成了一份可追溯的沟通档案，配合data/目录里的原始数据，长期留存也安心。

场景三：语音消息抢救 🔊

微信语音在备份里是 silk 私有格式，直接拿到的文件普通播放器打不开。WeChatExporter 导出时会调用项目自带的解码器自动转码，生成可直接播放的音频文件。如果你手上已有大量旧的 silk 语音想单独处理，development/framework/silk-v3-decoder/里的converter.sh支持批量转换，配合 ffmpeg 即可完成。

自动化与技巧：让备份更省心

• 数据目录规范化：每次用 iMazing 导出的 Documents 文件夹，建议按wechat_backup_2025Q1这样的时间戳命名，避免混淆，也让工具每次分析时目标清晰。
• 二次查看不走弯路：已经生成过的导出目录直接进「显示聊天记录」输入路径查看，比重新解析快得多，日常回看都用这条路径。
• 善用日期区间：导出界面右上角的日期范围是控制导出量的利器，批量备份大号聊天时务必用它分段，避免一次性生成超大文件。
• 日志定位问题：右上角【工具】→【导出运行日志】可导出完整日志，遇到问题先看日志，多数情况是版本不匹配导致。

避坑速查：5 个最高频的问题

延伸与展望

微信聊天记录本质上是一堆 SQLite 数据库文件（如MM.sqlite），WeChatExporter 做的事就是读懂它们：

如果你不满足于"会用"，想深入了解甚至二次开发，核心代码结构很清晰：

• 前端逻辑：development/js/controller/chatList.js（聊天列表）、development/js/controller/chatDetail.js（聊天详情）
• 数据解析：development/js/funcs.js（路径处理、MD5、图片转码）
• 界面模板：development/templates/，想改 UI 直接改 HTML 即可
• 技术栈：Node.js + AngularJS + SQLite3 + NW.js，构建走development/Gruntfile.js
• 官方文档：README.md

项目目前主要支持 iOS 备份 + macOS 运行，但代码完全开放，社区贡献的 PR 都在持续完善中——动手能力强的读者完全可以给它加上 Windows 适配或更多消息类型支持。

写在最后：备份不是选项，而是责任

回到开头那个朋友的故事。他失去的不是聊天记录，而是女儿从牙牙学语到背起书包的整个成长轨迹——那些语音里软糯的"爸爸"，那些视频里踉跄的第一步，全因为一次"没来得及备份"而永远消失了。数据只有在多一份拷贝时，才真正属于你。

WeChatExporter 的意义，就是把这件本来昂贵而复杂的事，变成一次免费、本地、可控的"数字记忆归档"。今天花半小时做完第一次备份，从此手机丢了、坏了、换了，你的回忆都还在。

现在就动手吧：备份手机 → 导出 Documents → 跑一遍工具 → 把 HTML 聊天包放进你的硬盘和云盘。每季度重复一次，让每一段对话都能穿越时间。

⚠️ 合规提醒：请仅将本工具用于自己设备上的个人数据备份。尊重他人隐私，不要尝试导出或查看任何人的聊天记录。合法合规使用，才能让开源工具走得更远。

【免费下载链接】WeChatExporter一个可以快速导出、查看你的微信聊天记录的工具项目地址: https://gitcode.com/gh_mirrors/wec/WeChatExporter