微信聊天记录导出工具 WeChatExporter 零基础完整上手指南从 iPhone 备份到本地永久归档【免费下载链接】WeChatExporter一个可以快速导出、查看你的微信聊天记录的工具项目地址: https://gitcode.com/gh_mirrors/wec/WeChatExporter你有没有过这样的瞬间换了新手机打开微信发现几十个群聊记录变成了空白或者某天手机突然黑屏才意识到和家人的几千条对话从来没有备份过。微信十年不提供官方导出聊天记录仿佛只能听天由命。WeChatExporter 正是为解决这个痛点而生的微信聊天记录导出工具——它不越狱、不折腾读取 iPhone 备份中的微信数据把文字、语音、图片、视频全部搬回你的电脑导出的记录能在本地 HTML 页面里随时翻阅离线也能看。一、全局速览它到底能帮你做什么动手之前先把预期立稳。这是一款能用、免费、开源的本地备份工具价值在于把官方一直没做的事交还到用户手里。维度说明✅ 核心能力无需越狱读取 iPhone 备份中的微信 Documents 数据完整解析并导出文字、语音、图片、视频、动画表情等消息语音自动转码为 mp3导出结果以本地网页形式呈现✅ 适合人群想永久保存家庭群聊、恋爱记录的个人用户需要归档客户沟通、项目记录的商务人士需要留存聊天证据的研究型用户✅ 不适合谁想直接导出安卓手机数据的人需先把记录迁到 iPad希望在 Windows 上获得开箱即用体验的人能用但未适配需自行折腾追求一键全自动的零代码用户一句话概括这是一款半小时上手、永久保存、完全本地的微信数据归档工具。二、破除误解写给新手的 3 句话很多人在 README 面前打了退堂鼓其实大部分顾虑都是误会。误解一工具是直接读取我手机里的微信不是。工具本身不碰手机它只读取你电脑上已有的微信数据文件。你的手机从头到尾不需要越狱、不需要解锁安全性有保证。误解二必须会写代码才能跑起来不需要。你只需要会执行几条命令、会点按钮。真正的难点——SQLite 模块编译——项目已经替你解决了下文会讲到懒人通道。误解三导出一次就完事以后看不了导出完成后工具会生成一个完整的 output 目录之后想查看聊天记录直接进入显示聊天记录页面填入目录即可无需重新解析秒开。三、一条主线实操从 0 到 1 完成第一次完整导出整个流程可以压缩成一句话不加密的 iTunes 备份 → 用 iMazing 取出微信 Documents → 装好 Node.js 与 NW.js → 跑起工具解析导出 → 在本地网页里慢慢回味。我们按这条主线分五步走每一步都标注预期结果让你随时确认自己走对了没有。第一步做一次不加密的 iTunes 整机备份把 iPhone 连上电脑打开 iTunes选择立即备份。这一步有一个必须牢记的红线⚠️千万不要勾选加密本地备份。一旦加密后面的工具将无法读取数据文件。这是新手最常踩的第一个坑没有之一。预期结果iTunes 界面显示备份完成备份文件里包含了微信 App 的全部数据。第二步用 iMazing 提取微信的 Documents 文件夹iTunes 备份是整机级别的而 WeChatExporter 只需要微信那一部分。用 iMazing 这类第三方工具打开备份定位微信应用把它的Documents 文件夹完整导出到电脑上存到哪都行记住路径即可。预期结果你得到了一个 Documents 文件夹里面有几个 32 位 MD5 命名的子文件夹对应登录过的不同微信账号每个账号下还有 DB、Audio、Img、Video 等子目录。其中DB/MM.sqlite就是聊天记录的总账本工具的核心工作就是解析它。 如果你用的是安卓机也别灰心先把聊天记录迁移到 iPad再按同样的流程导出即可。第三步装环境、拉代码15 分钟让工具站起来WeChatExporter 基于 Node.js 开发跑在 NW.jsnode-webkit桌面容器里所以两样都要装。版本号不是随便写的——它们和预编译的 SQLite 模块严格对应组件作用推荐版本Node.js项目运行与依赖管理8.11.3 或 10.16.3NW.js桌面应用运行环境0.32.1 或 0.40.1拉取项目并安装依赖git clone https://gitcode.com/gh_mirrors/wec/WeChatExporter cd WeChatExporter/development npm install重点来了这是全流程最容易劝退的一步。项目里的 sqlite3 需要针对 NW.js 重新编译过程相当折磨人要装 Xcode、配 node-gyp、指定 Python 2.7 路径……。但懒人福音是项目仓库的development/framework/目录下已经放好了编译好的node_sqlite3.node文件两个版本二选一node-webkit-v0.32.1-darwin-x64对应 nodejs 8.11.3 nwjs 0.32.1node-webkit-v0.40.1-darwin-x64对应 nodejs 10.16.3 nwjs 0.40.1把对应版本的文件夹整个拷贝到node_modules/sqlite3/lib/binding/目录下一步到位直接跳过编译地狱。启动工具npm start或者手动指定 NW.js 可执行文件/path/to/nw/nwjs.app/Contents/MacOS/nwjs .预期结果桌面上弹出微信备份主界面窗口说明环境这关已经通关。第四步选择账号与聊天对象生成导出数据进入界面后点击开始原始数据分析选择之前导出的 Documents 文件夹。左上角会列出这台手机上登录过的所有微信账号以 MD5 命名点选任意一个左下角立刻出现与你聊过天的联系人列表。 小细节列表默认只显示聊天消息总数超过 100 条的联系人或群聊冷门对话会被自动隐藏界面更清爽。点击左下角任意聊天对象右侧会实时预览最近 10 条记录帮你确认没选错人。确认无误后右上角会出现某某与某某的聊天记录红色提示点击进入下一步。在导出设置页里需要填两项数据导出目录导出的文件放哪里日期区间只导出某段时间的聊天不填则导出全部点击开始生成数据工具会逐条处理消息图片原图与缩略图分开归档、语音调用 silk 解码器转成 mp3、视频与缩略图也一并搬运。预期结果指定目录下生成一个完整的 output 文件夹此后 Documents 目录就没用了可以删除。第五步回到主页翻阅你的数字记忆回到工具主页选择显示聊天记录填入刚才的 output 目录一份完整的聊天记录就在眼前了文字、语音带播放条、图片、视频一应俱全界面模拟真实的聊天窗口还支持点击图片放大查看。预期结果你能像翻微信一样回看过去的对话此后随时进入显示聊天记录页面即可不需要重新解析。它能导出的消息类型一张表看明白消息类型导出表现文字消息完整保留可显示 QQ 表情图片消息原图 缩略图点击可放大语音消息自动转码为 mp3网页内直接播放视频/小视频保留 mp4 原文件支持内嵌播放动画表情占位显示分享链接占位显示位置/名片占位显示语音/视频通话占位显示系统消息占位显示如撤回提示诚实地说占位类型目前不展开正文这是项目作者在 README 里也坦承的不完善之处但完全不影响核心的文字、图片、语音、视频备份价值。四、深入一步把备份变成习惯的自动化脚本手动备份一次容易坚持备份很难。把备份变成定时任务才是真正意义上的数据保护。思路很简单写一个 shell 脚本固定好数据源Documents 目录和输出目录每次运行自动完成执行导出 → 验证结果 → 压缩归档三步再挂到 cron 定时执行。#!/bin/bash # wechat_backup.sh - 微信备份自动化脚本 DOC_DIR$HOME/WeChatDocuments # 你的 Documents 数据源 OUT_DIR$HOME/WeChatOutput # 导出工具的输出目录 ARCHIVE_DIR$HOME/WeChatArchives # 归档存放处 DATE$(date %Y%m%d) # 1. 确保输出目录存在 mkdir -p $ARCHIVE_DIR # 2. 检查数据源是否完整核心数据库必须在 if [ ! -f $DOC_DIR/DB/MM.sqlite ]; then echo [错误] 未找到 MM.sqlite请检查数据源路径 backup.log exit 1 fi # 3. 用工具生成数据此处填入你手动导出的 output 目录路径 # 若工具支持命令行调用可在此处替换为实际命令 # 4. 验证产物并压缩归档 if [ -d $OUT_DIR ]; then tar -czf $ARCHIVE_DIR/wechat_$DATE.tar.gz -C $OUT_DIR . echo [成功] 备份完成$ARCHIVE_DIR/wechat_$DATE.tar.gz backup.log else echo [失败] 输出目录不存在请检查导出步骤 backup.log exit 1 fi然后挂到 cron比如每周日凌晨 3 点执行crontab -e 0 3 * * 0 /path/to/wechat_backup.sh核心就一句话让机器替你记得备份这件事。脚本的具体逻辑可根据你的目录结构微调但执行 → 验证 → 归档三步闭环的思路是通用的。五、疑难杂症自查表遇到报错先别慌按下面的表格逐项排查多数问题都能自己解决。报错现象常见原因解决办法报错出现 xcodebuild / Xcode 字样走了源码编译路线系统没装 Xcode装好 Xcode 后执行sudo xcodebuild -license按空格翻完协议输入agree最省事的是直接用仓库里预编译的node_sqlite3.node绕开编译提示无法读取备份文件九成是 iTunes 备份被加密了重新做一次不勾选加密本地备份的备份再走一遍流程导出过程卡住或界面无响应磁盘空间不足内存被其他程序占满检查磁盘剩余空间语音转码和图片搬运很吃空间关掉其他大内存程序重启工具换个输出目录再试导出的语音播不了语音没有成功转码为 mp3先确认 output 目录的audio文件夹里有没有 mp3再检查 silk 解码器四件套是否完整converter.sh、ffmpeg、silk/decoder、silk/libSKP_SILK_SDK.a缺一不可其他疑难杂症最常见病因是版本不符软件右上角【工具】→【导出运行日志】会导出系统版本、Node 版本、NW.js 版本、sqlite3 绑定目录等信息把日志连同问题描述一起反馈给开发者六、技术架构速览为什么它这么轻快WeChatExporter 的架构很古典但很扎实技术型读者一眼就能看透WeChatExporter/development ├── index.html templates/ # AngularJS 模板首页、聊天列表、聊天详情 ├── js/ │ ├── app.js # AngularJS 模块与路由UI-Router │ ├── controller/ # chatList / chatDetail 控制器 │ ├── directive.js / filter.js # 自定义指令与过滤器 │ └── funcs.js # 工具函数时间戳、MD5、昵称解码 ├── framework/ # 预编译 SQLite 模块 silk 语音解码器 ├── css/ # Bootstrap 3 QQ 表情样式 └── package.json # 依赖与 npm start 脚本层技术选型职责前端AngularJS Bootstrap UI-Router界面交互与路由后端Node.js Express文件系统操作与数据解析数据库SQLite3读取微信 MM.sqlite 并重建为新的 data.sqlite桌面容器NW.jsnode-webkit让 Web 技术栈跑成桌面应用构建Grunt nw-builder打包分发因为完全开源你可以按需改造模板在development/templates/、控制器在development/js/、样式在development/css/。想加新消息类型、适配 Windows、支持导出 HTML 静态包都有现成的扩展点。写在最后备份不是选项是责任微信聊天记录里藏着的是家人的叮嘱、朋友的玩笑、工作上的重要决策以及那些再也无法复制的瞬间。WeChatExporter 的价值不在于功能多么炫酷而在于它把导出聊天记录这件官方一直没做的事用免费开源的方式交还到了用户手里。花半小时按本文走一遍流程你就拥有了一份永不丢失的数字记忆副本。重要提醒请仅将本工具用于个人合法数据的备份尊重他人隐私切勿尝试导出他人聊天记录。所有数据都在本地处理建议用加密容器存放备份并遵循3-2-1原则3 份副本、2 种介质、1 份离线。定期备份让每一段对话都能穿越时间。【免费下载链接】WeChatExporter一个可以快速导出、查看你的微信聊天记录的工具项目地址: https://gitcode.com/gh_mirrors/wec/WeChatExporter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 微信聊天记录导出工具 WeChatExporter 零基础完整上手指南：从 iPhone 备份到本地永久归档
微信聊天记录导出工具 WeChatExporter 零基础完整上手指南从 iPhone 备份到本地永久归档【免费下载链接】WeChatExporter一个可以快速导出、查看你的微信聊天记录的工具项目地址: https://gitcode.com/gh_mirrors/wec/WeChatExporter你有没有过这样的瞬间换了新手机打开微信发现几十个群聊记录变成了空白或者某天手机突然黑屏才意识到和家人的几千条对话从来没有备份过。微信十年不提供官方导出聊天记录仿佛只能听天由命。WeChatExporter 正是为解决这个痛点而生的微信聊天记录导出工具——它不越狱、不折腾读取 iPhone 备份中的微信数据把文字、语音、图片、视频全部搬回你的电脑导出的记录能在本地 HTML 页面里随时翻阅离线也能看。一、全局速览它到底能帮你做什么动手之前先把预期立稳。这是一款能用、免费、开源的本地备份工具价值在于把官方一直没做的事交还到用户手里。维度说明✅ 核心能力无需越狱读取 iPhone 备份中的微信 Documents 数据完整解析并导出文字、语音、图片、视频、动画表情等消息语音自动转码为 mp3导出结果以本地网页形式呈现✅ 适合人群想永久保存家庭群聊、恋爱记录的个人用户需要归档客户沟通、项目记录的商务人士需要留存聊天证据的研究型用户✅ 不适合谁想直接导出安卓手机数据的人需先把记录迁到 iPad希望在 Windows 上获得开箱即用体验的人能用但未适配需自行折腾追求一键全自动的零代码用户一句话概括这是一款半小时上手、永久保存、完全本地的微信数据归档工具。二、破除误解写给新手的 3 句话很多人在 README 面前打了退堂鼓其实大部分顾虑都是误会。误解一工具是直接读取我手机里的微信不是。工具本身不碰手机它只读取你电脑上已有的微信数据文件。你的手机从头到尾不需要越狱、不需要解锁安全性有保证。误解二必须会写代码才能跑起来不需要。你只需要会执行几条命令、会点按钮。真正的难点——SQLite 模块编译——项目已经替你解决了下文会讲到懒人通道。误解三导出一次就完事以后看不了导出完成后工具会生成一个完整的 output 目录之后想查看聊天记录直接进入显示聊天记录页面填入目录即可无需重新解析秒开。三、一条主线实操从 0 到 1 完成第一次完整导出整个流程可以压缩成一句话不加密的 iTunes 备份 → 用 iMazing 取出微信 Documents → 装好 Node.js 与 NW.js → 跑起工具解析导出 → 在本地网页里慢慢回味。我们按这条主线分五步走每一步都标注预期结果让你随时确认自己走对了没有。第一步做一次不加密的 iTunes 整机备份把 iPhone 连上电脑打开 iTunes选择立即备份。这一步有一个必须牢记的红线⚠️千万不要勾选加密本地备份。一旦加密后面的工具将无法读取数据文件。这是新手最常踩的第一个坑没有之一。预期结果iTunes 界面显示备份完成备份文件里包含了微信 App 的全部数据。第二步用 iMazing 提取微信的 Documents 文件夹iTunes 备份是整机级别的而 WeChatExporter 只需要微信那一部分。用 iMazing 这类第三方工具打开备份定位微信应用把它的Documents 文件夹完整导出到电脑上存到哪都行记住路径即可。预期结果你得到了一个 Documents 文件夹里面有几个 32 位 MD5 命名的子文件夹对应登录过的不同微信账号每个账号下还有 DB、Audio、Img、Video 等子目录。其中DB/MM.sqlite就是聊天记录的总账本工具的核心工作就是解析它。 如果你用的是安卓机也别灰心先把聊天记录迁移到 iPad再按同样的流程导出即可。第三步装环境、拉代码15 分钟让工具站起来WeChatExporter 基于 Node.js 开发跑在 NW.jsnode-webkit桌面容器里所以两样都要装。版本号不是随便写的——它们和预编译的 SQLite 模块严格对应组件作用推荐版本Node.js项目运行与依赖管理8.11.3 或 10.16.3NW.js桌面应用运行环境0.32.1 或 0.40.1拉取项目并安装依赖git clone https://gitcode.com/gh_mirrors/wec/WeChatExporter cd WeChatExporter/development npm install重点来了这是全流程最容易劝退的一步。项目里的 sqlite3 需要针对 NW.js 重新编译过程相当折磨人要装 Xcode、配 node-gyp、指定 Python 2.7 路径……。但懒人福音是项目仓库的development/framework/目录下已经放好了编译好的node_sqlite3.node文件两个版本二选一node-webkit-v0.32.1-darwin-x64对应 nodejs 8.11.3 nwjs 0.32.1node-webkit-v0.40.1-darwin-x64对应 nodejs 10.16.3 nwjs 0.40.1把对应版本的文件夹整个拷贝到node_modules/sqlite3/lib/binding/目录下一步到位直接跳过编译地狱。启动工具npm start或者手动指定 NW.js 可执行文件/path/to/nw/nwjs.app/Contents/MacOS/nwjs .预期结果桌面上弹出微信备份主界面窗口说明环境这关已经通关。第四步选择账号与聊天对象生成导出数据进入界面后点击开始原始数据分析选择之前导出的 Documents 文件夹。左上角会列出这台手机上登录过的所有微信账号以 MD5 命名点选任意一个左下角立刻出现与你聊过天的联系人列表。 小细节列表默认只显示聊天消息总数超过 100 条的联系人或群聊冷门对话会被自动隐藏界面更清爽。点击左下角任意聊天对象右侧会实时预览最近 10 条记录帮你确认没选错人。确认无误后右上角会出现某某与某某的聊天记录红色提示点击进入下一步。在导出设置页里需要填两项数据导出目录导出的文件放哪里日期区间只导出某段时间的聊天不填则导出全部点击开始生成数据工具会逐条处理消息图片原图与缩略图分开归档、语音调用 silk 解码器转成 mp3、视频与缩略图也一并搬运。预期结果指定目录下生成一个完整的 output 文件夹此后 Documents 目录就没用了可以删除。第五步回到主页翻阅你的数字记忆回到工具主页选择显示聊天记录填入刚才的 output 目录一份完整的聊天记录就在眼前了文字、语音带播放条、图片、视频一应俱全界面模拟真实的聊天窗口还支持点击图片放大查看。预期结果你能像翻微信一样回看过去的对话此后随时进入显示聊天记录页面即可不需要重新解析。它能导出的消息类型一张表看明白消息类型导出表现文字消息完整保留可显示 QQ 表情图片消息原图 缩略图点击可放大语音消息自动转码为 mp3网页内直接播放视频/小视频保留 mp4 原文件支持内嵌播放动画表情占位显示分享链接占位显示位置/名片占位显示语音/视频通话占位显示系统消息占位显示如撤回提示诚实地说占位类型目前不展开正文这是项目作者在 README 里也坦承的不完善之处但完全不影响核心的文字、图片、语音、视频备份价值。四、深入一步把备份变成习惯的自动化脚本手动备份一次容易坚持备份很难。把备份变成定时任务才是真正意义上的数据保护。思路很简单写一个 shell 脚本固定好数据源Documents 目录和输出目录每次运行自动完成执行导出 → 验证结果 → 压缩归档三步再挂到 cron 定时执行。#!/bin/bash # wechat_backup.sh - 微信备份自动化脚本 DOC_DIR$HOME/WeChatDocuments # 你的 Documents 数据源 OUT_DIR$HOME/WeChatOutput # 导出工具的输出目录 ARCHIVE_DIR$HOME/WeChatArchives # 归档存放处 DATE$(date %Y%m%d) # 1. 确保输出目录存在 mkdir -p $ARCHIVE_DIR # 2. 检查数据源是否完整核心数据库必须在 if [ ! -f $DOC_DIR/DB/MM.sqlite ]; then echo [错误] 未找到 MM.sqlite请检查数据源路径 backup.log exit 1 fi # 3. 用工具生成数据此处填入你手动导出的 output 目录路径 # 若工具支持命令行调用可在此处替换为实际命令 # 4. 验证产物并压缩归档 if [ -d $OUT_DIR ]; then tar -czf $ARCHIVE_DIR/wechat_$DATE.tar.gz -C $OUT_DIR . echo [成功] 备份完成$ARCHIVE_DIR/wechat_$DATE.tar.gz backup.log else echo [失败] 输出目录不存在请检查导出步骤 backup.log exit 1 fi然后挂到 cron比如每周日凌晨 3 点执行crontab -e 0 3 * * 0 /path/to/wechat_backup.sh核心就一句话让机器替你记得备份这件事。脚本的具体逻辑可根据你的目录结构微调但执行 → 验证 → 归档三步闭环的思路是通用的。五、疑难杂症自查表遇到报错先别慌按下面的表格逐项排查多数问题都能自己解决。报错现象常见原因解决办法报错出现 xcodebuild / Xcode 字样走了源码编译路线系统没装 Xcode装好 Xcode 后执行sudo xcodebuild -license按空格翻完协议输入agree最省事的是直接用仓库里预编译的node_sqlite3.node绕开编译提示无法读取备份文件九成是 iTunes 备份被加密了重新做一次不勾选加密本地备份的备份再走一遍流程导出过程卡住或界面无响应磁盘空间不足内存被其他程序占满检查磁盘剩余空间语音转码和图片搬运很吃空间关掉其他大内存程序重启工具换个输出目录再试导出的语音播不了语音没有成功转码为 mp3先确认 output 目录的audio文件夹里有没有 mp3再检查 silk 解码器四件套是否完整converter.sh、ffmpeg、silk/decoder、silk/libSKP_SILK_SDK.a缺一不可其他疑难杂症最常见病因是版本不符软件右上角【工具】→【导出运行日志】会导出系统版本、Node 版本、NW.js 版本、sqlite3 绑定目录等信息把日志连同问题描述一起反馈给开发者六、技术架构速览为什么它这么轻快WeChatExporter 的架构很古典但很扎实技术型读者一眼就能看透WeChatExporter/development ├── index.html templates/ # AngularJS 模板首页、聊天列表、聊天详情 ├── js/ │ ├── app.js # AngularJS 模块与路由UI-Router │ ├── controller/ # chatList / chatDetail 控制器 │ ├── directive.js / filter.js # 自定义指令与过滤器 │ └── funcs.js # 工具函数时间戳、MD5、昵称解码 ├── framework/ # 预编译 SQLite 模块 silk 语音解码器 ├── css/ # Bootstrap 3 QQ 表情样式 └── package.json # 依赖与 npm start 脚本层技术选型职责前端AngularJS Bootstrap UI-Router界面交互与路由后端Node.js Express文件系统操作与数据解析数据库SQLite3读取微信 MM.sqlite 并重建为新的 data.sqlite桌面容器NW.jsnode-webkit让 Web 技术栈跑成桌面应用构建Grunt nw-builder打包分发因为完全开源你可以按需改造模板在development/templates/、控制器在development/js/、样式在development/css/。想加新消息类型、适配 Windows、支持导出 HTML 静态包都有现成的扩展点。写在最后备份不是选项是责任微信聊天记录里藏着的是家人的叮嘱、朋友的玩笑、工作上的重要决策以及那些再也无法复制的瞬间。WeChatExporter 的价值不在于功能多么炫酷而在于它把导出聊天记录这件官方一直没做的事用免费开源的方式交还到了用户手里。花半小时按本文走一遍流程你就拥有了一份永不丢失的数字记忆副本。重要提醒请仅将本工具用于个人合法数据的备份尊重他人隐私切勿尝试导出他人聊天记录。所有数据都在本地处理建议用加密容器存放备份并遵循3-2-1原则3 份副本、2 种介质、1 份离线。定期备份让每一段对话都能穿越时间。【免费下载链接】WeChatExporter一个可以快速导出、查看你的微信聊天记录的工具项目地址: https://gitcode.com/gh_mirrors/wec/WeChatExporter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考