3步导出微信聊天记录：WeChatMsg使用指南

3步导出微信聊天记录：WeChatMsg使用指南

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

上个月换手机，我需要做一次完整的微信聊天记录导出，把五年的记录留下来。试了几款工具后选了 WeChatMsg：全程本地运行，能把记录导出成 HTML、Word、CSV，还能生成年度聊天报告，10 分钟就能跑完。

快速上手：安装WeChatMsg并跑通首次导出

克隆项目并安装依赖，仓库很轻量，装上依赖清单里的包就能用：

git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg pip install -r requirements.txt

安装完成后直接运行主入口验证，这条命令会把全部聊天记录做一遍导出：

python main.py

记录多时首次解析本地数据库会慢几分钟，属正常现象。

提示Mac 上若报 sqlcipher 相关编译错误，先执行brew install sqlcipher再重装依赖，这是首次搭建最常见的卡点。

导出微信聊天记录：三个核心场景

一键导出全部微信聊天记录

典型场景：换手机、离职交接，或某个群快被解散，需要完整存档。直接运行上一步的python main.py，无需参数。脚本解析微信本地加密数据库，默认把所有会话导出成 HTML，用浏览器打开即可按时间线阅读，图片和表情保留原样；需要归档时也可切换 Word 或 CSV 格式输出。

按时间段筛选导出微信记录

典型场景：整理归档时只要最近两年，不想把更早的记录全部搬出来。传入时间区间参数：

python main.py --start-date 2024-01-01 --end-date 2024-12-31

输入是起止日期，输出是只包含该区间消息的导出文件，适合做"毕业季记录""某项目群记录"这类按场景归档。

生成微信年度聊天报告

典型场景：年终回顾，想用数据看看这一年跟谁聊得最多、消息里图片占多少。报告功能同样在主入口，运行时传入目标年份：

python main.py --generate-report --year 2024

输出是一份可视化报告：按小时划分的活跃分布、互动最多的核心社交圈、文字/图片/语音的占比统计。可视化样式还在迭代，2025 版年度报告页面的效果如下：

进阶玩法：自动备份与批量格式转换

给聊天记录设置定期自动备份

1. 把python main.py（带上你需要的参数）写进一个 shell 脚本。
2. 用 crontab 注册定时任务，例如每月 1 号凌晨 1 点自动执行。
3. 导出目录按年月命名存放，方便日后检索对比。

多格式导出与二次分析

1. CSV 可直接用 pandas 或 Excel 打开，自行做词频、活跃度统计。
2. 大批量导出时优先用 CSV + 压缩存放，占空间最小。

微信聊天记录导出常见问题

提示该项目已长期归档、不再积极维护（作者在 readme 中说明）。如果你使用的微信版本较新导致解密失败，多半是版本不兼容，趁当前版本还能解析，尽早把记录备份出来。

Q1：导出文件默认保存在哪里？保存在项目根目录下的 exports 目录，自动按会话名称建子目录；HTML 文件双击用浏览器打开即可阅读。

Q2：聊天记录会被上传或泄露吗？不会。解析和导出全程在你本机执行，数据不离开设备。用完可自行清理导出目录或收紧访问权限。

Q3：只想导出某个人的记录可以吗？可以。运行时指定目标会话，就只导出该联系人或群的消息，不需要全量导出。

先把你今年的记录导出存一份吧，项目说明与问题反馈见 readme.md。

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