简介：WeChatMsg（MemoTrace）是一款面向普通用户与开发者的微信聊天记录导出及留存开源工具，核心解决微信聊天数据占用空间大、重要记录难以持久保存和深度分析的问题；它支持将聊天记录导出为HTML、Word、Excel等常见格式，也能生成年度聊天报告，甚至利用聊天数据训练个人专属AI助手。导出的数据按月份和页面总数自动归类，体积极小，1.4GB的群聊导出后仅约18MB，任意浏览器均可直接打开阅读，适合长期归档与本地检索。资源包共259个文件，主要包含Python源码、HTML模板、PNG/SVG图标素材、exe可执行组件（如ffmpeg）以及md/json/yml等配置与说明文档，压缩包整体约24.69MB，结构清晰，便于二次开发与功能扩展。目前已有1900人学习下载，需要留意的是，本项目严格遵循“我的数据我做主”的开源理念，不能找回已删除的聊天记录，使用者应遵守开源协议与相关法律法规。 WeChatMsg 这个工具我关注挺久了，从最早的测试版一直用到 2.0.10，说实话它解决了一个非常“痛点”的问题：手机或者电脑里的微信聊天记录想导出来，又不想一条条截图，还不想把隐私数据传到第三方服务器。它就在本地把记录解密、解析、格式化，导出成 HTML、Word、CSV 这些通用格式给你。适合谁？适合想给聊天记录做长期备份的人、需要整理对话作为凭证的职场用户、想把自己和某个人的聊天记录做成纪念册的普通人，甚至是拿聊天数据做文本分析的研究型用户。
因为这类工具直接碰的是本机数据库和本地会话密钥，很多人第一次用会担心“会不会把数据传出去”“是不是在破解微信”。这篇我基于自己实际操作 WeChatMsg 2.0.10 的过程，从原理到实操再到踩坑记录，一次性说清楚，保证你看完能独立完成一次完整的聊天记录导出。
1. 先搞明白 WeChatMsg 到底做了什么
1.1 它解决的问题和适合谁
微信目前没有官方提供“一键导出全部聊天记录为文档”的功能，平时的迁移要么手机到手机，要么靠聊天记录备份到电脑，但备份出来的文件是加密的、只能恢复到微信里看，没办法做二次编辑和归档。真想把某段对话打印出来、写进游记、整理成工作留痕，传统做法基本只有截图，效率低还不方便检索。
WeChatMsg 就是在这个夹缝里出现的工具。它运行在你已经登录过微信的电脑上，读取本机微信存储目录下的数据库文件，借助当前登录状态下的会话密钥，把 SQLite 数据库解密，再把聊天消息、联系人、群聊信息解析成可读的数据，最终导出成多种格式。整个过程全在本地完成，不需要把数据上传到任何云端。
适合的人群主要有这么几类：一是长期被“换手机丢聊天记录”困扰、希望定期归档的人；二是需要把客户沟通记录导出来整理成项目文档的运营和销售岗位；三是想把恋爱纪念聊天记录做成 PDF 的普通人；四是对微信内容做词频分析的研究者。无论哪种，前提都是你能合法接触到这些聊天记录本身。
1.2 核心原理：一条 SQLite 解密链路
微信电脑版的聊天记录不是简单存成一个文本文件，而是存进了本地 SQLite 数据库，而且这个数据库用了 SQLCipher 加密。SQLCipher 是 SQLite 的加密扩展，所有页面数据在写入磁盘前都会加密，没有正确的密钥，拿到的数据库文件就是一坨无法解析的字节流。
这个密钥不会写在配置文件里，而是运行中存在于微信进程的内存里。WeChatMsg 做的事就是遍历当前已登录的微信进程，从内存中提取出主密钥，再调用 SQLCipher 的解密接口去打开数据库。打开之后，它会把内部的消息表、联系人表读出来，按联系人 ID 和历史消息顺序重新组合成可读的会话结构，再吐给你选定的导出格式。
这套流程听起来不复杂，但工程上要注意的细节非常多：不同版本微信的数据库 schema 不一样、消息类型字段不统一（文本、图片、视频、表情、引用消息、转账、文件等近百种）、日期格式是 Unix 时间戳还是毫秒级时间戳、数据库表损坏时怎么跳过坏页……WeChatMsg 能把这些都处理好，说明作者在逆向解析和数据兼容上确实下了功夫。
2. 工具选型思考：为什么这类工具值得关注
2.1 对比截图方案和云端解析服务
聊天记录导出的替代方案就三种：截图、用系统自带的聊天记录迁移、用云端同步后从网页端复制。但截图遇到长对话特别笨，一次只能截一屏，而且图片里的文字没法搜索；聊天记录迁移只能把数据原封不动搬到另一台设备，不能生成 PDF 或 CSV；从云端复制则受时间范围限制，很久以前的记录未必还在本地。
WeChatMsg 这种本地解析工具最大的优势是“解密后结构化”。导出的 CSV 可以直接用 Excel 打开，按日期筛选、按联系人分组、提取特定关键词都很方便，导出的 HTML 也带有消息气泡样式，看起来和微信页面差不多，不管打印还是存档都很舒服。
还有一个隐性优势：它天然规避了隐私上传的顾虑。很多人不是不想导，而是不敢把自己的聊天记录发给在线解析网站，生怕被拿去训练模型或泄露给第三方。WeChatMsg 是开源项目，代码逻辑公开可审查，整个解密和解析都在你本机 CPU 上完成，这一点在信任度上碾压所有“上传加密数据库到云端换取导出结果”的闭源服务。
2.2 WeChatMsg 2.0.10 的功能全貌
2.0.10 这个版本算是项目迭代比较成熟的阶段，几个关键点值得一说：
- 支持导出格式：TXT、HTML、CSV、Word、PDF，基本覆盖了阅读、打印、数据分析的需求。
- 消息类型覆盖全：文本、图片、语音、视频、文件、转账、引用消息、拍一拍等都能解析，图片还可以选择是否导出原图。
- 支持数据库自动检测：启动后会自动匹配微信数据目录，不用自己手动找文件夹。
- 支持多账号切换：如果你在电脑上用多个微信号登录过，工具会列出多个账号的数据库，可以选其中一个导出。
- 内置词云功能：对聊天内容做简单的文本分析，能生成高频词云图，适合快速观察沟通主题。
- 提供“年度报告”生成：类似微信年度聊天报告的效果，按月和联系人维度统计消息数量、活跃时间等，做可视化展示。
其中我认为最值钱的不是年度报告，而是 CSV 导出。拿一个客服账号举例，过去一个月几千条咨询，如果把客户昵称、时间、消息内容、方向全部导成 CSV，用数据透视表很快就能看出高频问题集中在哪几个品类。这个能力已经超出了一般“聊天记录工具”的定位，更像是把微信变成个人知识库的入口工具。
3. 实操：从下载到导出一次走通
3.1 下载与环境准备
先是下载。WeChatMsg 的发布页面在 GitHub 的 Releases 区，搜索 WeChatMsg 就能找到项目仓库，下载WeChatMsg-2.0.10.zip这个包。下载时优先选择 zip 压缩包，因为不需要走安装流程，解压就能用，这也是典型开源工具的风格。
解压之后检查一下文件结构，主程序文件、配置文件、运行依赖即使被打在一起，个别版本还是需要.NET 8 桌面运行时。如果你双击之后提示缺少 Runtime、报找不到hostfxr.dll或coreclr.dll，不用慌，去微软官方下载中心装对应的 .NET 8 Desktop Runtime (x64)，装完再启动就行。实操中我发现，Windows 10/11 很容易碰到这个环境问题，建议在下载工具的同时顺手把.NET 8运行时也装了，省得报错来回折腾。
另外两个前置条件必须提前确认：
- 电脑上已经安装并登录过微信 PC 版，且该账号的聊天记录在本地有保留。如果微信平时开启的是“不保留聊天记录”，导出结果会很空。
- 希望导出的对话在手机或电脑端的微信里有完整历史数据。如果只靠手机漫游到电脑，那么电脑上只会有最近同步过来的一部分。
3.2 核心流程：读取密钥并解密数据库
打开 WeChatMsg 主界面后，工具会引导你点击一个“获取聊天记录”或“备份导出”类按钮，这时它会在后台扫描内存中的微信进程，尝试读取当前登录账号的主密钥。这个环节千万不要把微信退出，否则密钥就取不到了。
如果提取成功，日志区会显示类似“获取到密钥”的提示，程序会自动用这个密钥去尝试解密本机微信文件目录下的数据库。常见的数据文件名叫MSG.db（消息库）、MicroMsg.db（联系人库）、MediaMSG.db（媒体消息库）等，它们平时是加密的，此时会被临时解密到内存或者临时目录中用于解析。
首次运行可能还会让你指定微信的数据目录，如果工具没自动检测到，可以自己进微信客户端，在“设置 — 文件管理 — 打开文件夹”里看到实际存储路径，把这个文件夹路径填回工具即可。注意这里填的路径要包含xwechat_files或类似的一层目录，具体取决于微信版本，但不要选错成“文档”里的空文件夹。
3.3 导出与格式选择
解密完成后，进入导出页面。先选择要导出的账号，再选择联系人或群聊，可以单选也可以多选；随后设置时间范围，比如只导出某年某月到某年某月；最后选择导出格式和保存位置。
不同格式的实际使用场景我从自己体验来对比：
| 格式 | 优点 | 缺点 | 推荐场景 |
|---|---|---|---|
| HTML | 保留聊天界面样式，图片能嵌入 | 文件体积大，传播稍重 | 个人存档、网页展示 |
| TXT | 体积最小，通用性最强 | 无法显示图片和样式 | 纯文字提取、备份 |
| CSV | 适合 Excel 分析、筛选、统计 | 长文本和多行内容容易乱 | 数据统计、文本挖掘 |
| Word | 排版可控，可打印 | 图片多了打开慢 | 正式文档、诉讼留痕 |
| 跨设备格式固定、无法改 | 长聊天记录生成慢 | 发给他人、打印归档 |
实操中我最常用的是 CSV + HTML 的组合：CSV 用来拉数据做统计，HTML 用来肉眼翻阅和存档。需要提醒的是，导出的图片、语音、视频等媒体文件，通常会在导出目录里单独生成 Image 或 File 子文件夹。尤其是语音文件格式可能是.amr或.silk，普通播放器打不开，建议只导图片和视频相关的内容，语音的应用价值有限。
3.4 进阶玩法：词云和年度报告
如果导出的对话积累了很多年，2.0.10 内置的词云功能会很有趣味性。它会统计消息文本中的高频词，去停用词后生成一张词云图，颜色和字体大小按词频分配。把整个聊天记录跑一遍，往往能直观看出两个人聊天的核心话题是工作、家庭还是共同爱好。
年度报告功能则更像可视化的总结，按时间维度统计出每个月的消息量、活跃时间段、聊天最频繁的联系人 Top N、消息峰值日期等。遇到过不少用户拿这个做纪念册入场页，也有自由职业者拿它做客户沟通密度复盘。但从数据分析的严谨性来看，词云和年度报告只是“锦上添花”，真正的深度分析还是建议把 CSV 导到 Python 里跑 jieba 分词，那才有更细的洞察。
4. 避坑指南：我在导出记录时踩过的坑
4.1 常见问题排查清单
这类工具虽然用起来像一键导出的傻瓜软件，但实际运行环境千奇百怪，我整理了一些高频问题，按出现概率排序：
| 问题现象 | 根本原因 | 解决办法 |
|---|---|---|
| 提示“获取密钥失败” | 微信没在后台运行，或不是当前登录状态 | 打开微信 PC 版重新登录，等完全进入主界面后再点获取 |
| 能读到密钥但导出内容为空 | 微信设置里勾选了退出时自动清理聊天记录 | 微信设置中关闭自动清理，下次登录聊几句生成新数据库再试 |
| 点击导出后程序崩溃或无响应 | 某条异常消息类型导致解析器报错 | 缩小时间范围分段导出，找到“问题日期区间”单独处理 |
| 杀毒软件报毒或拦截 | 读取进程内存的行为被安全软件判定为敏感操作 | 添加白名单后重试，优先从官方 Release 下载校验哈希 |
| 导出后的 CSV 中文乱码 | 编码不是 UTF-8 with BOM | 用记事本另存为带 BOM 的 UTF-8，或用能识别 UTF-8 的工具打开 |
| 找不到微信数据库目录 | 多级路径识别失败 | 手动打开微信“设置—文件管理”复制路径，再粘贴到工具里 |
| 数据库解密不完整 | 微信版本升级后表结构变化 | 更新到最新版 WeChatMsg，等待作者适配新数据库 schema |
这里面最容易忽略的是“退出时自动清理聊天记录”这个开关。很多人电脑上的微信只用来扫码偶尔收个文件，其实大部分聊天记录根本没有同步下来，或者被微信清理过。导出来发现只有最近几天的内容，先别怀疑工具，先看看微信本地的存储情况和设置项。
4.2 高价值操作心得
第一次完整导出大账号数据库时，我建议先选一个几十 MB 的小群或单联系人做测试，顺手验证导出格式是否符合预期，然后再跑全量。全量导出几千条消息可能会生成上百 MB 的 HTML，打开和翻页都会变得卡顿，不如按年份分几次导然后合并目录。
关于路径问题也有个细节：保存导出结果时，文件夹路径里尽量不要带中文、空格和特殊符号。工具本身支持中文路径，但后续用 Excel、Python 处理文件时，路径里的中文和空格经常会引出一堆编码问题，直接放在D:\WeChatExport\2024\这种纯字母数字路径下省心很多。
图片导出建议单独勾选“下载原图”或“原图导出”，否则导出的是压缩略缩图，放大后没法做证明或打印。不过原图导出速度会慢不少，而且占用的磁盘空间会显著上升，导之前确认一下剩余空间够不够。
4.3 合规边界与隐私安全提醒
必须反复强调一点：这个工具只能用来导出你自己账号下有权访问的聊天记录，或者已经获得充分授权的会话数据。不要试图通过获取他人的数据库文件来偷看别人和第三方的聊天内容，那是严重越界的行为。
导出后的文件同样要小心保管。HTML/PDF/CSV 里是完整对话，包含双方昵称、时间、可能还有地理位置和文件。不要长期裸露放在公共网盘或能被局域网设备直接访问的共享目录里。我个人的习惯是导出后立刻压缩成加密 zip，归档到移动硬盘，再开启双因素认证的私有云同步。聊天记录本质上是非常私密的个人数据，工具能帮你解放数据，但后续的责任仍然在你身上。
4.4 数据备份的优先级心得
用这个工具多了以后，我最大的一个体会是：导出聊天记录这件事，要充分理解“趁早”两个字。微信版本升级、电脑更换、系统重装前的任何一个时刻，都可能让你永远失去一份本来还可以导出、可以归档的数据。我已养成的习惯是每季度固定做一次全量导出，时间范围覆盖最近三个月的所有对话，格式同时选 HTML 和 CSV，价格两条路：HTML 用于未来快速翻看，CSV 用于统计和临时处理。
另外，如果电脑上有多个微信账号的历史数据，建议每个账号都分开导出、单独建文件夹。后续微信如果升级改版把数据库位置变了，你至少有历史导出的备份兜底，不会因为一次升级就彻底失联过去的重要对话。
我在实际使用中的体会是，WeChatMsg 这类工具的魅力不在于“技术有多黑魔法”，而在于它把本来被锁死在私有格式里的个人记录，重新变成了你可以自由阅读、编辑和保存的普通文件。当然，每次拿到新版本、新格式、新功能时，也要学会克制——导出前先确认范围，导出后及时备份，比工具多好用更重要。最后再分享一个小技巧：导出 HTML 时如果觉得默认样式不够好看，可以自己改一下模板里的 CSS，把气泡颜色、页面留白和字体大小调成自己喜欢的样子，这样生成的存档看起来完全就像一本私人定制的小册子，翻起来很有仪式感。
本文还有配套的精品资源，点击获取
