WeChatExporter 实战指南:3 步完成微信聊天记录导出与本地备份

📅 2026/8/22 1:46:53
WeChatExporter 实战指南:3 步完成微信聊天记录导出与本地备份
WeChatExporter 实战指南3 步完成微信聊天记录导出与本地备份【免费下载链接】WeChatExporter一个可以快速导出、查看你的微信聊天记录的工具项目地址: https://gitcode.com/gh_mirrors/wec/WeChatExporter旧 iPhone 准备转手或系统大版本升级前你想把多年的微信聊天记录完整留在电脑上但微信官方并没有提供完整的导出入口。WeChatExporter 就是为这类 Mac iOS 用户准备的聊天记录导出工具从 iPhone 备份中解析微信的数据库把文字、语音、图片、视频导出到本地文件夹全程在电脑本地完成数据不经过任何第三方服务器。备份前的环境自查清单开工前先对照下面 6 条任何一条不满足就先补上能省掉后面大量返工✅ 运行环境是macOS该工具的界面与运行只适配 Mac✅ 数据源是iOS 设备iPhone 或 iPad。安卓用户需先用微信自带的聊天记录迁移与备份把记录迁到 iPad再走本文流程✅ 已安装 Node.js 和 nwjsnwjs 是把网页应用打包成本地桌面程序的运行时这里负责打开工具窗口✅ Node.js 与 nwjs 版本匹配nodejs 8.11.3 nwjs 0.32.1或 nodejs 10.16.3 nwjs 0.40.1 这两组可以直接用项目预编译好的 sqlite3 插件✅ 如自行编译 sqlite3需安装 Xcode用预编译插件则可跳过✅ 预留磁盘空间整份 iPhone 备份通常有好几个 GB导出结果还要再占一份一图看懂聊天记录是怎么被解析出来的微信的聊天记录不在云端而是存在手机里微信应用 Documents 目录下的 SQLite 数据库文件中SQLite 是一种文件式数据库消息内容、发送人、时间戳都是其中的数据行。WeChatExporter 的路径很直接先让 iTunes 做一次不加密的整机备份再用第三方工具把微信的 Documents 文件夹从备份里提取出来然后工具直接读取数据库按账号 聊天对象定位对话按你给的时间范围输出到本地文件夹。iPhone 整机备份iTunes不加密 ↓ 提取微信 Documents 文件夹iMazing 等第三方工具 ↓ 解析 MM.sqlite 聊天数据库 联系人数据库 ↓ 选账号 → 选对话 → 按日期范围生成导出 ↓ 本地 output 文件夹文字 / 语音 / 图片 / 视频上图为提取出的 Documents 文件夹内部结构32 位 MD5 命名的目录对应一个登录过的微信账号DB 目录下的 MM.sqlite 就是聊天记录所在。全流程实战从 iPhone 备份到聊天回看阶段一取出微信的 Documents 数据文件夹打开 iTunes连接 iPhone选中设备后在备份区域选择备份到本机点击立即备份。不要勾选给 iPhone 备份加密这是整个流程最关键的一步。 验证方法iTunes 界面显示最新的备份时间已更新如果你之前的备份勾了加密那份备份无法使用需要重做。![iTunes 备份设置界面导出微信数据前不要勾选给 iPhone 备份加密](https://raw.gitcode.com/gh_mirrors/wec/WeChatExporter/raw/976c9474db687bb592d4a623edb0ec42ee831a18/imgs/for readme/backup1.png?utm_sourcegitcode_repo_files)上图即备份选项页给 iPhone 备份加密保持不勾选即可。打开 iMazing或同类备份管理工具在左侧设备树中找到文件系统 → 微信应用AppDomain-....tencent.xin展开 Documents 文件夹将其完整拷贝到 Mac。 验证方法拷贝出的文件夹中应至少有一个 32 位十六进制命名的子目录进入其中能找到 DB/MM.sqlite 文件说明数据完整。![iMazing 从 iPhone 备份中提取微信 Documents 文件夹的操作界面](https://raw.gitcode.com/gh_mirrors/wec/WeChatExporter/raw/976c9474db687bb592d4a623edb0ec42ee831a18/imgs/for readme/backup2.png?utm_sourcegitcode_repo_files)上图为在 iMazing 中定位微信应用并选中 Documents 文件夹的过程。阶段二在 Mac 上安装并启动 WeChatExporter获取代码并安装依赖git clone https://gitcode.com/gh_mirrors/wec/WeChatExporter cd WeChatExporter/development npm install准备 sqlite3 插件二选一懒人路线推荐你的版本组合是 nodejs 10.16.3 nwjs 0.40.1或 8.11.3 0.32.1时项目已备好预编译文件把 framework 下对应文件夹拷到指定位置即可cp -R framework/node-webkit-v0.40.1-darwin-x64 node_modules/sqlite3/lib/binding/编译路线其他版本需自行编译先安装 node-gyp 再执行注意--target必须与你的 nwjs 版本一致--target_arch按 64 位/32 位填 x64 或 ia32sudo npm install -g node-gyp npm install sqlite3 --build-from-source --runtimenode-webkit --target_archx64 --target0.40.1验证方法node_modules/sqlite3/lib/binding/ 下出现 node-webkit-v版本号-darwin-x64 目录里面有 node_sqlite3.node 文件。用 nwjs 启动工具把路径换成你本机 nwjs 的位置/path/to/nw/nwjs.app/Contents/MacOS/nwjs .验证方法弹出标题为微信备份的窗口能看到开始原始数据分析按钮说明环境全部就绪。阶段三选账号选对话生成导出文件点击开始原始数据分析选择阶段一拷贝出的 Documents 文件夹。 验证方法左上角列出这台手机登录过的微信账号列表为空说明目录选错了。点击某个账号左下角显示聊天对象列表默认只显示消息总数超过 100 的对话点击任意聊天对象右侧会预览最近 10 条消息用来确认没选错人。![微信聊天记录导出工具的分析界面左侧选账号与聊天对象右侧预览最近消息](https://raw.gitcode.com/gh_mirrors/wec/WeChatExporter/raw/976c9474db687bb592d4a623edb0ec42ee831a18/imgs/for readme/soft1.png?utm_sourcegitcode_repo_files)上图为主分析界面左侧是账号和聊天对象含消息总数右侧是所选对话的最近记录预览确认后点右上角下一步。填写文件输出路径日期区间留空表示全部导出需要只导某一年也可以在此限制。点击开始生成数据。 验证方法生成结束后 output 目录里出现聊天数据与媒体文件。此时 Documents 文件夹已没有用途可以删掉释放空间。导出结果长什么样三种角色怎么用在工具的显示聊天记录页面输入刚才的 output 目录你会得到一个接近微信原貌的列表页自己的消息在右侧绿色气泡对方的在左侧语音消息带播放器可直接播放并调音量文字、图片、视频都在按时间顺序往下翻就能逐条回看。![导出后的微信聊天记录查看界面语音可播放文字与图片完整展示](https://raw.gitcode.com/gh_mirrors/wec/WeChatExporter/raw/976c9474db687bb592d4a623edb0ec42ee831a18/imgs/for readme/soft3.png?utm_sourcegitcode_repo_files)上图为查看导出的聊天记录多年前的语音依然可以播放时间戳和发送方完整保留。旧机退役 / 换新手机在抹掉旧设备之前把重要账号的聊天对象全量导出一份output 文件夹存到移动硬盘再同步一份云盘。旧机即使被重置或转卖记录仍在你手里。工作交接用日期区间只导出某个项目群在合作期间的对话连同项目文档一起交给接手同事比逐条转发消息完整得多。个人回忆归档按聊天对象列表翻找与朋友、家人的旧对话。默认的 100 条消息门槛会自动过滤掉低频对话帮你快速定位到有内容价值的会话。踩坑速查6 个高频问题Q1备份做好了工具却提示读不到数据库大概率是备份时勾了给 iPhone 备份加密。加密备份里的数据库文件是加密的无法直接读取需要重做一份不加密的整机备份。Q2编译 sqlite3 时报 xcode-select: error: tool xcodebuild requires Xcode说明 Xcode 没装或没接受许可。安装 Xcode 后在终端执行sudo xcodebuild -license读完按空格输入 agree再重新编译。Q3我用的是安卓手机能用吗官方流程只支持 iOS 数据。可以先用微信自带的迁移与备份把聊天记录迁到 iPad再按本文 iOS 流程操作。Q4聊天对象列表里没有我预期的小群或好友列表默认只显示消息总数超过 100 条的对话低频聊天不会出现这是筛选行为不是数据丢失。Q5导出的语音不能播放或媒体缺失先确认拷贝的是完整的 Documents 文件夹媒体文件都在其子目录里语音解码依赖项目自带的 Silk 解码器development/framework/silk-v3-decoder不要删掉这个目录。Q6没报明确错误问题从哪查起点右上角[工具] → [导出运行日志]看日志最常见的原因是 Node.js、nwjs、sqlite3 插件三者版本不匹配对照自查清单核对版本。完成首次导出后的建议走完上面全部步骤你得到的是一个完全离线可读的文件夹消息、发送人、时间戳、语音、图片全部落在本地整个导出过程没有任何数据上传到第三方服务器。需要说明的是作者在 README 中坦言项目当前处于半维护状态对消息类型的覆盖尚不全面也不支持 Windows 与安卓数据源使用前的版本细节以仓库内最新说明为准项目也明确欢迎 PR 参与完善。今天就完成第一次全量导出把 output 目录分别存到移动硬盘和云存储两处把先导出、再操作变成习惯升级系统、换机、转卖旧设备之前各做一次完整备份遇到缺失的消息类型或不兼容的系统可以直接阅读 development/js 下的解析代码并提交 PR【免费下载链接】WeChatExporter一个可以快速导出、查看你的微信聊天记录的工具项目地址: https://gitcode.com/gh_mirrors/wec/WeChatExporter创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考