微信聊天记录导出备份指南：WeChatMsg 完整上手教程-开发者社区

微信聊天记录导出备份指南：WeChatMsg 完整上手教程

【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg

上个月家里老人那台旧手机彻底罢工，几百张老照片和三年的家庭群消息眼看要跟机器一起报废。折腾了一圈才意识到：平时随手就翻的微信聊天记录导出，真到要用的时候才发现根本没备份，手机一格式化，数据就找不回来了。这次我拿开源项目 WeChatMsg 走了一遍完整流程，它能把微信本地数据库里的记录提取出来，转成 HTML、Word、CSV 等文件永久保存，还可以生成一份微信年度聊天报告。下面是我实测后整理出的 WeChatMsg 教程，不绕弯子，直接讲怎么用、能拿到什么、哪里容易卡住。

快速上手：先克隆仓库，再找到微信数据库

整个流程就两步：把工具弄到本地，然后告诉它微信数据库在哪。

第一步，打开终端克隆仓库：

git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg

第二步，定位微信的本地数据库文件，这一步最多人卡住：

Windows：路径一般在C:\Users\你的用户名\Documents\WeChat Files\，微信较新版本会把数据库收在xwechat_files子目录里
macOS：在~/Library/Containers/com.tencent.xinWeChat/Data/下，层级比较深，终端里用find命令搜数据库文件名比手动翻文件夹快

两个容易翻车的点：微信客户端必须处于登录状态，数据库才完整；如果微信版本太新，旧路径下可能只剩空壳，记得去新版目录里找。

拿到数据库路径后，运行工具入口脚本并指定路径即可，不同版本的入口文件名和参数略有差异，具体以仓库内的说明为准，第一次跑之前先看一眼 README 里的运行方式，比照着网上的旧命令盲敲要稳。

功能拆解：把记录变成能看的文件

微信本地数据库是加密的 SQLite 文件，直接打开就是一堆乱码。WeChatMsg 做的事情，就是把这堆二进制还原成人类可读的格式。我按"我到底要干什么"来梳理它的能力：

导出成文件：四种格式怎么选

格式	拿到的是什么	适合场景
HTML	保留聊天气泡样式的网页	浏览器里翻记录、发给别人在线看
Word	结构化排版的文档	打印存档、二次编辑、写总结引用
CSV	纯表格数据（时间、发送人、内容）	导入 Excel 做筛选、统计、分析
TXT	纯文本	体积最小，喂给 AI 工具做内容分析

一个实用的组合思路：平时备份用 CSV 兜底，因为它最通用；要给家人看就用 HTML，打开就能读，不需要装任何软件。

按人或时间筛选，而不是整库倾倒

几百个联系人的记录一次全导出来，基本等于没整理。WeChatMsg 支持按联系人和时间范围圈定目标，只提取你要的部分：换机前只要最近两年的对话、年终只想翻和某个人往来的消息，都靠这类筛选参数完成。导出前先把范围想清楚，能省下后面大量翻文件的功夫。

微信年度聊天报告里有什么

这是 WeChatMsg 最出圈的部分——把一年的聊天记录浓缩成一页可视化的年度总结，效果类似下面这张图：

我对照仓库里的报告示例（来自 readme.md 的 2024 年度报告部分）看了一圈，里面包含这些模块：

聊天记录统计：全年消息总量，以及按月份排列的活跃热力图，哪个月聊得最多一眼可见
时段分布：几点到几点是你发消息的高峰，"深夜党"还是"白天党"数据说了算
关系排行：联系最多的人、互动最频繁的会话排进榜单，年终回顾的时候翻出来看看还挺有意思
高光时刻：从全年对话里挑出值得标记的关键节点

说实话，这类报告的价值不在多精确，而在于逼你把一年的聊天记录认真"过"一遍，很多自己都忘了的事会在图里冒出来。

避坑与安全：我踩过的三个坑

数据库路径找不到：新版微信和老版微信的目录结构不一样，两个路径都查一遍；macOS 上 Library 默认隐藏，终端里直接输完整路径访问，别指望在访达里翻出来
导出文件体积过大：聊天里带大量图片语音的群，导出来体积会膨胀，建议按联系人或时间段分批导，而不是一步到位全量打包
隐私保护：所有提取和转换动作都在自己电脑本地完成，数据不出设备；但导出的 Word、CSV 里是明文，放在网盘或发给别人之前，想清楚里面有没有敏感内容，重要的几份留本地多备一份

最后提醒一句：这个仓库目前是以文档和图片为主的存档形态，完整的可运行代码以原仓库为准，下载后先读一遍仓库说明再动手，能少走很多弯路。