企业官网建设流程全解析

微信聊天记录导出从零开始：WeChatExporter完整实操记录，把旧对话变成可翻阅的永久网页

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

微信聊天记录导出这件事，说难不难，说简单也不简单。今天要介绍的 WeChatExporter，是一款基于 Node.js 开发的免费开源工具，无需越狱手机，就能把 iPhone 里的微信聊天记录（文字、语音、图片、视频）完整导成一份可离线翻阅的 HTML 档案。下面这份实操记录，是我从装环境、跑通全流程到踩坑排雷的真实经历，所有命令都亲自验证过，新手照着抄也能一次成功。

先聊聊：我是怎么撞见这个工具的

一次换机恐慌，逼我开始研究微信聊天记录导出

事情是这样的：上个月我的 iPhone 存储空间告急，准备换新机。真到迁移那一步才发现，微信的聊天记录迁移只能"搬家"，不能"备份"——新手机一旦出问题，旧数据可能就彻底没了。再加上官方一直没提供完整的聊天记录导出功能，我越想越不踏实：这几年攒下的家庭群聊、工作沟通、老同学的珍贵回忆，难道就只能活在手机里？

于是我花了一个晚上搜"如何导出微信聊天记录"，翻遍了各种方案，最后锁定了 WeChatExporter。理由很简单：开源、免费、本地运行，数据不出电脑，隐私有保障。

给新手交个底：它适合谁，不适合谁

先说人话版结论，你对照自己的情况看：

一句话：它是"导出器 + 查看器"，不是"同步云盘"。把定位搞清楚，后面就不会有落差。

一句话认识 WeChatExporter

WeChatExporter = 微信聊天记录导出工具。它读取 iPhone 备份中的微信数据库，解析出文字、语音、图片、视频等各类消息，再生成一份带界面的 HTML 网页，供你在电脑上随时翻阅。整个过程完全在本地完成，不依赖任何第三方服务器，断网也能用。

别急着重装环境，先看看导出成果长什么样

一份能双击打开、翻页浏览的 HTML 聊天档案

先看成果，再讲过程，这样你才有动力往下走。导出完成后，你会拿到一个文件夹，里面最核心的是一份 HTML 页面。双击打开，登录过这台手机的微信账号、聊过天的对象全部陈列在左侧，右侧就是完整的对话内容，和微信里的聊天界面几乎一模一样。


白绿气泡、头像、时间戳一应俱全，语音消息还会转成网页里可以直接播放的格式。滚动浏览、翻页查找都很顺滑，就像在翻一本只属于你的聊天杂志。

文字、语音、图片、视频，一个都没少

我实测下来的完整能力清单如下：

先认清单：它能做什么，不做什么

• 能：把微信聊天记录导出为 HTML、在工具内直接预览对话、按日期范围筛选导出、多账号切换查看。
• 不能：不支持安卓直连导出（需先迁移到 iOS 设备）、不支持 Windows 原生运行、不支持云端自动同步。

把这些边界想清楚，你在动手时就不会冒出"怎么还有这一步"的疑问。

动手前，请先备齐这三样东西

第一样：一台 Mac 和一根数据线

WeChatExporter 当前主要适配 macOS，作者的开发环境也是 Mac，所以第一步就是把你的 Mac 准备好。数据线用来连接 iPhone 做备份，建议用原装线，减少中途断连的意外。

第二样：一份"未加密"的 iPhone 整机备份

这是整条流程里最关键、也最容易出错的一步。用 iTunes（或访达）把 iPhone 连上 Mac，创建一份完整备份，切记不要勾选"加密本地备份"。一旦勾选加密，WeChatExporter 就读不到里面的数据了，后面全部白搭。


备份完成后，再用 iMazing 之类的第三方工具，从备份里把微信应用的Documents 文件夹单独导出来。没错，我们只需要微信自己的那份数据，里面装着聊天记录数据库，以及图片、语音、视频等附件。这个文件夹请妥善保管，后面导出全靠它。

第三样：Node.js、NW.js 和源码包

WeChatExporter 是 Node.js 项目，桌面端跑在 NW.js 环境里，所以两样都得装：

• Node.js：到官网下载 LTS 版本装好即可；
• NW.js：建议选 0.40.1 版本，和项目预编译的模块正好匹配，能省掉最劝退的编译环节。

最后就是源码本身，下一节统一讲怎么拿。项目的使用说明在仓库自带的 README.md 里也有，遇到问题时可以对照着看。

第一次实操：四步跑通微信聊天记录导出

第1步：拉取源码，装好依赖

打开终端，执行下面的命令把项目拉到本地：

git clone https://gitcode.com/gh_mirrors/wec/WeChatExporter cd WeChatExporter/development npm install

解释一下这三行在做什么：

• git clone把项目源码完整复制到本地电脑；
• cd进入开发目录，所有核心代码都在这里；
• npm install根据 package.json 自动下载项目依赖，包括 sqlite3、express 等库。

依赖装完后，node_modules目录里就会出现 sqlite3 等模块。

第2步：让 SQLite 模块"一步到位"

微信的聊天记录存在 SQLite 数据库里，WeChatExporter 靠sqlite3模块来读取。这个模块需要针对 NW.js 环境单独编译，对新手来说是最劝退的一步。

好在项目作者已经预编译好了两个版本，直接拿来用：

# 如果你用的 NW.js 是 0.40.1（推荐用这个） cp -r framework/node-webkit-v0.40.1-darwin-x64 node_modules/sqlite3/lib/binding/

这条命令把framework/目录下预编译好的node_sqlite3.node文件夹整体拷贝到 sqlite3 模块的 binding 目录里，相当于"跳过编译、直接安装成品"，一分钟搞定。如果你用的是 0.32.1 版本的 NW.js，就换成对应版本号的那个文件夹。

第3步：启动工具，导入 Documents 数据

用 NW.js 打开项目即可启动工具：

/path/to/nw/nwjs.app/Contents/MacOS/nwjs .

注意最后的.表示以当前目录（也就是 development 目录）为项目根目录来运行。启动后你会看到一个本地界面，第一步就是导入刚才从备份里导出的Documents 文件夹。工具会自动扫描里面的微信数据库，并列出在这台手机上登录过的所有微信账号。

第4步：选对话、定范围、一键导出

导入成功后就到了最爽的一步。界面左侧会列出所有聊过天的对象（默认只显示消息数超过 10 条的对话），右侧会实时预览最近的 10 条消息，帮你确认"选对人了没"。


确认无误后点击"下一步"，进入导出设置页：

• 输出目录：决定导出的 HTML 档案放在哪里；
• 日期范围：可只导出某个时间段的内容，不填就是全部导出。

填好之后点"开始生成数据"，稍等片刻，一个完整的聊天记录文件夹就诞生了。至此，最初那份 Documents 文件夹的使命完成，可以删掉了。

新手最容易踩的四个坑（含对照解法）

常见困扰与我的现场解法对照表

这一路我几乎把常见问题踩了个遍，直接做成对照表，省得你重复交学费：

万能钥匙：导出运行日志怎么看

如果上面的表没能救你，记住一个万能招：在工具右上角点【工具】→【导出运行日志】，把日志导出后逐行看。日志里会明确写出你的系统版本、Node 版本、NW.js 版本和 sqlite3 的 binding 目录情况。十有八九的问题都出在"版本对不上"，对照着改准没错。

三句话讲透：它凭什么把数据库变成网页

它其实只干了两件事：解析数据、渲染页面

WeChatExporter 的核心逻辑不复杂：第一步，用 sqlite3 读取微信数据库，把每条消息解析成带时间、类型、内容的记录；第二步，把解析结果套进 AngularJS 模板，渲染成 HTML 页面。前端框架是 AngularJS，运行环境是 Node.js，桌面壳由 NW.js 提供。以微信账号命名的数据库文件（如 MM.sqlite）就是它读取的对象，核心代码都在 development/js/ 目录下。

为什么语音消息非要"转个码"

微信的语音是私有格式（silk），浏览器直接播放不了。WeChatExporter 在导出时会调用解码器把语音转成通用的 MP3 格式，再嵌入网页。这也是它能在电脑上"原汁原味"播放语音的原因——转码这一步，正是它贴心的地方。

源码里藏着哪些可以二次开发的模块

既然是开源项目，你就能按需魔改：界面模板在 development/templates/ 目录，想改样式直接动这里；功能逻辑在 development/js/controller/ 下，聊天列表和详情页的逻辑分文件存放，改起来很清晰。对想学 Node.js 或 AngularJS 的开发者来说，这也是一个不错的实战参考。

两个真实场景：什么时候你会感谢今天的自己

场景一：换手机前，把三年的对话全部带回家

我自己的真实案例：换机前花了一个晚上，用 WeChatExporter 把三年来的家庭群聊、朋友往来、工作沟通全部导成了 HTML 档案，存进移动硬盘和网盘各一份。现在想找某年某月说过的一句话，打开网页搜一下就出来了，比在手机上翻聊天记录快得多。

场景二：把工作群的重要资料归档成册

做项目的人都有体会：很多关键决策散落在各个工作群里，想复盘的时候根本找不全。用这个工具把相关对话按时间段导出，就是一份带时间戳、可翻阅的"项目沟通档案"。配合它的日期范围筛选功能，想归档哪个阶段就归档哪个阶段，特别顺手。

结尾：现在，轮到你了

第一步，就从这份备份开始

备份这件事，最怕的不是麻烦，而是"以后再说"。而"以后"往往意味着手机出问题的那一天。今天的你只需要做三件事：连上手机做一份不加密备份、导出 Documents 文件夹、照着上面的四步跑一遍。半小时的投入，换来的是很多年后依然能翻开的老朋友。

请记住的合规底线

最后提醒一句：请把这个工具用于你自己的数据备份，不要尝试导出他人的聊天记录。尊重隐私，合法使用，让备份成为习惯，让回忆永不丢。

现在就去连上你的 iPhone 吧——第一份微信聊天记录导出，从今天开始。

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