桌面应用【免费下载链接】WechatExporterWechat Chat History Exporter 微信聊天记录导出备份程序项目地址https://gitcode.com/gh_mirrors/we/WechatExporter点击查看免费下载导读WechatExporter 是一个用 C 重写的跨平台微信聊天记录导出与备份工具它直接读取 iTunes/iOS 备份中的微信数据将聊天记录解析后导出为 Text、HTML、PDF 三种格式并支持异步加载、消息过滤、增量导出与页面模板定制。本文以项目 README.md 为主线结合仓库源码WechatExporter/core/、WechatExporter/res/templates/等深入讲解其使用步骤、导出选项、增量导出原理与模板定制方法读完你可以独立完成一次从手机备份到聊天记录归档的全流程操作并理解其底层实现机制。项目定位C 重写的跨平台聊天记录导出工具微信 PC 端在 Windows 3.7.6 内测版、macOS 3.5.5 Beta 版中上线了聊天记录迁移功能可以将 Mac 端与手机端的聊天记录互相迁移、合并浏览也可将手机端聊天记录备份至 PC 端以缩减微信体积。WechatExporter 正是面向这一场景的开源方案它参考了 stomakun/WechatExport-iOS外部参考项目的设计思路改用 C 实现以在各平台以更少依赖运行同时增加了聊天群名称的解析支持和更多消息类型的导出支持导出格式支持 Text、HTML、PDF 三种。从仓库目录结构看项目包含三大工程部分WechatExporter/macOS/iOS 工程Xcode含ViewController.mm、AppDelegate.mm等 UI 层代码vcproject/Windows 工程Visual Studio含WechatExporter.sln、WechatExporter.vcxproj、MainFrm.h等 MFC/WTL 界面代码WechatExporter/core/与平台无关的核心逻辑包括备份解析ITunesParser.h、微信数据解析WechatParser.h、消息解析MessageParser.h、导出调度Exporter.h、增量导出上下文ExportContext.h以及 PDF 转换接口PdfConverter.h等。这种核心逻辑与平台 UI 分离的结构正是该工具能够同时覆盖 Windows 与 macOS 的基础。核心功能特性一览根据 README.md 的说明WechatExporter 的核心能力包括三种消息加载方式导出的聊天记录页面可以设置为「打开时一次性加载完成」默认方式、「打开时异步加载」、「页面滑动到底部时加载更多」可在菜单选项中修改页面过滤功能可以在导出的页面增加过滤功能按关键词搜索、按消息类型筛选同样在菜单选项中设置PDF 导出实质是先导出打开时一次性加载完成的 HTML 页面再通过 Google Chrome 或 Microsoft Edge 浏览器转换成 PDF 文件转换耗时较长过程中不要关闭自动弹出的命令行窗口增量导出在菜单选项中设置增量导出后仅导出上一次导出最后一条消息之后的部分再次备份后微信中的聊天记录可以删除下一次导出可以把同一个聊天群的后续消息合并到一起。这些选项在源码层面与 Exporter.h 中的设置接口一一对应void setTextMode(bool textMode true); void setPdfMode(bool pdfMode true); void setOrder(bool asc true); // 消息时间倒序导出 void saveFilesInSessionFolder(bool flags true); // 头像/表情文件存入聊天记录子目录 void setSyncLoading(bool syncLoading true); // 一次性加载 void setLoadingDataOnScroll(bool loadingDataOnScroll true); // 滚动加载 void setIncrementalExporting(bool incrementalExporting); // 增量导出 void supportsFilter(bool supportsFilter true); // 页面过滤 void useRemoteEmoji(bool useEmojiUrl); // 使用远端表情 URL而 MessageParser.h 中定义的SessionParsingOption位标志SPO_TEXT_MODE、SPO_PDF_MODE、SPO_DESC、SPO_ICON_IN_SESSION、SPO_SYNC_LOADING、SPO_SUPPORT_FILTER、SPO_INCREMENTAL_EXP等则揭示了这些选项在消息解析阶段的底层影响——例如SPO_ICON_IN_SESSION表示把头像和表情文件存放到聊天记录子目录SPO_USING_REMOTE_EMOJI对应远端表情SPO_TEXT_MODE0xFFFF代表纯文本导出模式。操作步骤从 iTunes 备份到聊天记录归档第一步通过 iTunes 备份手机通过 iTunes 将手机备份到电脑上备份时不要选择设置口令加密备份无法直接解析ITunesParser.h 中的BackupManifest结构体也显式记录了m_encrypted加密标志Windows 系统下备份一般位于目录C:\用户\用户名\AppData\Roaming\Apple Computer\MobileSync\Backup\Android 手机用户可以找一个 iPad/iPhone 设备先用微信的聊天记录迁移功能把聊天记录迁移到 iPad/iPhone 上然后通过 iTunes 备份到电脑。第二步到第四步下载、运行、按界面操作从项目的发布Releases页面下载最新版本的执行文件最新版本下载见 README 顶部Windows 提供 x64 版本macOS 提供 x64 版本执行解压出来的WechatExport.exe/WechatExporter.app。Windows 下如果运行报缺少必需的 DLL 文件请安装 Visual C 2017 Redistributable 后再尝试运行下载地址见 README系统依赖一节按界面提示进行操作选择 iTunes 备份目录与导出目录、勾选要导出的聊天会话、配置导出选项后点击导出。下面是 Windows 与 macOS 两个平台的实际程序界面从 macOS 截图可以看到界面提供的典型导出选项备份目录选择、导出目录选择、「按消息时间倒序导出」「头像和表情文件存放到聊天记录子目录」「仅导出文本」「HTML 数据异步加载」等复选框底部还显示当前关联的 iTunes、iOS、微信版本信息对应 Exporter.h 中的getITunesVersion()、getIOSVersion()、getWechatVersion()接口。第五步查看导出结果导出完成后的页面为浏览器可打开的 HTML 文件页面样式与消息气泡布局由模板目录控制详见下文模版修改小节。消息类型覆盖不止文本和图片WechatExporter 在原始参考项目的基础上扩展了更多消息类型的解析。以 MessageParser.h 中定义的常量为例顶层消息类型MSGTYPE_*包括常量值含义MSGTYPE_TEXT1文本消息MSGTYPE_IMAGE3图片消息MSGTYPE_VOICE34语音消息MSGTYPE_SHARECARD42名片分享MSGTYPE_VIDEO43视频消息MSGTYPE_EMOTICON47表情MSGTYPE_LOCATION48位置消息MSGTYPE_APP49应用/小程序消息App 消息MSGTYPE_SYS10000系统消息MSGTYPE_RECALLED10002撤回消息MSGTYPE_APP49之下还细分了APPMSGTYPE_*子类型文本1、图片2、语音3、视频4、链接5、附件6、表情15、转发消息19、视频号卡片50、视频号动态51、聊天记录引用57、转账2000、红包2001等转发消息内部又区分FWDMSG_DATATYPE_*文本、图片、视频、链接、位置、附件、名片、嵌套转发17、小程序19、视频号22等。MessageParser中相应的parseText、parseImage、parseVoice、parseVideo、parseAppMsg*、parseFwdMsg*系列方法见 MessageParser.h即为各类型消息到 HTML 模板值TemplateValues的转换实现。导出页面加载模式与过滤功能的底层实现三种加载方式如何工作导出的 HTML 页面加载逻辑集中在 frame.html 的脚本中。页面通过asyncLoadingType变量区分加载策略一次性加载默认HTML 中直接内联全部消息内容打开时异步加载asyncLoadingType initial页面加载完成后通过loadMsgsForNextPage()动态请求消息分页数据滚动到底部加载更多asyncLoadingType onscroll监听页面滚动事件接近底部时pageOffset containerDivOffset - 20触发loadMsgsForNextPage()。异步模式下消息被拆分成msg-N.js分页文件%%DATA_PATH%%/msg- pageNumber .js见 frame.html每页消息数量由%%SIZE_OF_PAGE%%占位符控制默认 100总消息数与总页数由%%NUMBER_OF_MSGS%%、%%NUMBER_OF_PAGES%%注入。页面过滤功能过滤功能由 filter.html 提供页面顶部生成关键词输入框回车触发searchElements匹配span.dspname发送者昵称与span.msg-text消息文本以及「照片」「视频」「所有」三个快捷筛选按钮分别调用showImageMsgs、showVideoMsgs、showAllMsgs最终通过filterMsg按msgType属性筛选div.msg元素。过滤时若可见消息数不足一页还会自动继续加载下一页消息保证筛选结果完整。历史 Bug 提醒1.8.0.7 及以前版本README 特别标注了一个历史问题1.8.0.7 以前版本的异步加载方式存在较严重的 Bug——设置为滚动到页面底部异步加载时越靠后的页码加载的消息数量越少设置为打开全部消息异步加载时消息只能加载到一半。处理方式如果 iTunes 备份还存在请使用 1.8.0.8 及以上版本重新导出如果过往备份已清除可下载 1.8.0.8 的补丁程序Win64 / macOS 64 位两个版本解压后把wxexpatch.exeWindows/wxexppatchmacOS拷贝到导出目录并执行即可修复已导出的页面补丁修复的文件清单可查看日志文件patch.log。如果你仍在使用旧版本导出的页面这一点需要特别留意。增量导出原理按会话记录消息游标增量导出是备份后删除微信聊天记录、再次导出合并这一工作流的基石。其实现集中在 ExportContext.h核心数据结构是m_maxIdForSessions以聊天会话用户名usrName为键、记录该会话已导出的最大消息 IDint64_t maxId导出时通过getMaxId(usrName, maxId)读取游标导出完成后通过setMaxId(usrName, maxId)更新游标整个上下文通过serialize()序列化为 JSON字段含options、exportTime、sessions数组其中每项为{usrName, maxId}下次导出时通过unserialize()反序列化恢复游标Exporter.h 的hasPreviousExporting(outputDir, options, exportTime)用于检测输出目录中是否存在上次导出记录。对应地SessionParser.h 中buildMsgEnumerator(session, minId)支持从指定最小 ID 开始枚举消息正是增量导出只导出游标之后的消息的取数入口。因此增量导出的完整链路是上次导出的maxId→ 本次按minId过滤 → 仅导出新增消息 → 更新游标并写回导出上下文。PDF 导出的实质与注意事项PDF 模式并非直接生成 PDF 文件。README 明确说明PDF 格式实质是导出打开时一次性加载完成的 HTML 页面然后通过 Google Chrome 或者 Microsoft Edge 浏览器的打印功能转成 PDF 文件。因此PDF 模式下页面必须一次性加载完成不能使用异步加载模式否则内容不完整转 PDF 文件耗时较长请不要关闭自动弹出的命令行窗口平台层通过 PdfConverter.h 定义抽象接口makeUserDirectory、convert(htmlPath, pdfPath)由各平台实现macOS 见WechatExporter/PdfConverterImpl.hWindows 见vcproject/PdfConverterImpl.h。模版修改自定义导出页面样式解压目录下的res\templatesmacOS 版本位于Contents\Resources\res子目录存放了输出聊天记录的 HTML 页面模板模板支持通过%%变量%%形式的占位符注入数据。README 强调通过两个%包含起来的字符串如%%NAME%%不要修改除此之外的页面内容和格式都可以自行调整。仓库中WechatExporter/res/templates/下提供了完整的模板集例如listitem.html会话列表项模板使用%%ITEMPICPATH%%头像路径、%%ITEMLINK%%链接、%%ITEMTEXT%%显示文本三个占位符msg.html普通文本消息气泡模板使用%%ALIGNMENT%%左/右对齐、%%MSGID%%、%%MSGTYPE%%、%%AVATAR%%、%%NAME%%、%%TIME%%、%%MESSAGE%%等占位符audio.html语音消息模板通过%%AUDIOPATH%%注入音频文件路径渲染audio controls播放器frame.html整页骨架样式、头部、异步加载与过滤脚本%%DISPLAYNAME%%、%%USRNAME%%、%%SESSION_USRNAME%%、%%BODY%%、%%HEADER_FILTER%%等占位符filter.html过滤栏片段关键词搜索框与照片/视频/所有按钮其余还有image.html、video.html、card.html、share.html、refermsg.html、channels.html、emoji.html、notice.html、system.html、plainshare.html等按消息类型划分的模板res/templates_txt/目录下则是对应的纯文本导出模板Text 格式导出使用。要定制导出样式只需修改这些 HTML 模板中的布局、CSS 或增加辅助脚本重新导出即可生效注意保留所有%%XXX%%占位符及其语义。README 特别感谢了 Chao.M 帮忙优化当前的模板。系统依赖与运行环境README 明确的系统要求如下Windows 版本Windows 7 及以上不支持 XP需要安装 Visual C 2017 Redistributable官方最新支持的 Visual C 下载页面见 README系统依赖一节MacOS 版本macOS 10.10Yosemite及以上。程序编译第三方依赖与平台差异WechatExporter 依赖以下第三方库完整清单见 README.md「程序编译」一节库用途/说明平台libxml2XML 解析聊天消息 XML 内容解析对应XmlParser通用libcurl网络请求远程表情、头像下载等通用libsqlite3SQLite 数据库读取微信MM.sqlite、message_*.sqlite通用libprotobufProtobuf 解析微信部分数据格式通用libjsoncppJSON 解析/序列化如导出上下文的读写通用lameMP3 编码语音转码见Utils_audio.cpp、Utils_silk.cpp通用silk微信 SILK 语音解码通用libplistApple plist 解析备份 Manifest通用libiconv字符编码转换仅 Windowsopenssl加密/摘要仅 WindowsWTLWindows UI 框架仅 Windows编译注意事项来自 READMEMacOS 下libxml2、libcurl、libsqlite3直接使用 Xcode 自带的库其它第三方库需自行编译libmp3lame需手动删除文件include/libmp3lame.sym中的lame_init_old行Windows 下silk自带 Visual Studio 工程文件可以直接利用 Visual Studio 编译其余除了libplist之外都通过 vcpkg 编译libplist在 vcpkg 中也存在但在编译x64-windows-statictarget 时报了错因此直接通过 Visual Studio 建立工程进行编译。如需获取源码自行编译可使用git clone https://gitcode.com/gh_mirrors/we/WechatExporter克隆仓库。备份数据在备份包中的位置源码级补充了解数据在哪有助于排查导出异常。从 WechatParser.h 中的过滤器可以还原微信数据在 iTunes 备份中的典型路径结构UserFolderFilter匹配Documents/32位哈希/DB/MM.sqlite即每个微信账号的数据库目录32 位哈希为用户目录标识MessageDbFilter在用户目录下匹配DB/message_1~4位数字.sqlite即分片消息数据库MMSettingInMMappedKVFilter匹配Documents/MMappedKV/mmsetting.archive.uid.crc对应通过 MMKVReader.h 读取的 MMKV 键值存储用于解析用户名、昵称、头像等SessionCellDataFilter匹配celldataV7之类的会话列表缓存文件备份文件索引本身Manifest、ITunesFile结构体见 ITunesParser.hisDir()通过flags 2判断目录项。这也是 README 强调备份时不要设置口令的原因——加密备份会破坏这些原始文件的直接可读性。已测试的 iTunes 与微信版本组合README 末尾列出了开发者在实际环境中的兼容性验证记录可作为选择备份/微信版本的参考操作系统iTunes 版本微信版本iOS 版本Windows12.3.3.176.5.9—Windows12.5.1.216.3.30—Windows12.10.10.27.0.2—Windows12.10.9.37.0.15—Windows12.9.5.57.0.2—Windows 1012.11.0.26Microsoft Store7.0.2 / 8.0.1—macOS CatalinaEmbedded iTunes—8.0.1 / 8.0.2—Windows 712.10.9.38.0.2—Windows 1012.11.3.178.0.7—Windows 7 / macOS Catalina12.10.9.3Embedded iTunes7.0.2iOS 9.3.5Windows12.10.3.17.0.10iOS 13.3macOS 11.6Embedded iTunes—8.0.9iOS 15.0macOS 11.6Embedded iTunes—8.0.18iOS 15.4注意以上为项目仓库中记录的实测组合不代表对所有版本的承诺实际使用时以「iTunes 未加密备份 对应微信版本」为基本前提。小结WechatExporter 的完整工作流可以概括为iTunes 未加密备份 → 解析备份中的微信数据库MM.sqlite / message_*.sqlite / MMKV→ 按会话枚举并解析各类消息 → 套用 HTML 模板或纯文本模板生成导出页面 → 可选异步分页/过滤/增量合并 → 可选经 Chrome/Edge 转为 PDF。对普通用户掌握 README 中的五步操作即可完成备份与导出对开发者core/目录下的解析器与模板机制则提供了清晰的可扩展路径——新增消息类型、定制页面样式、接入其他备份格式都可以从对应模块入手。赞分享桌面应用【免费下载链接】WechatExporterWechat Chat History Exporter 微信聊天记录导出备份程序项目地址https://gitcode.com/gh_mirrors/we/WechatExporter点击查看免费下载相关推荐微信聊天记录导出备份程序WechatExporter 完全指南微信聊天记录导出备份程序WechatExporter 完全指南 项目介绍 WechatExporter 是一个开源工具专为需要导出和备份微信聊天记录的用户设桌面应用上一篇经典游戏联机教程四步用 IPXWrapper 让红警、星际在 Win10/11 重新连上局域网下一篇一条命令整站下载Python 网站下载工具离线保存完整指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考