WeChatMsg 完整教程：如何 3 步导出微信聊天记录，还能生成年度报告
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
第一次跑完 WeChatMsg，输出目录里比我预想的多了一层文件夹：每个联系人一个 HTML 子目录，还有一份我没指定的 CSV。这个免费开源的微信聊天记录导出工具，把微信电脑版的对话完整搬进了本地目录，全程不经过云端。我前后花了两天把它从头到尾走通，下面是这期间的笔记。
为什么我要把聊天记录导出到本地
微信本身没有导出入口，换手机、重装系统时历史全靠自己迁移。截图一页页翻不现实，数据留在云端也不踏实，能落到本地的纯文本副本才最可靠。
所以"微信聊天记录导出"这件事的需求其实很简单：全量一份、离线一份、以后还能翻。
WeChatMsg 是什么，跑之前要准备什么
WeChatMsg 是一个开源工具，解析微信电脑版本地产生的数据库，把对话导出成 HTML、Word、CSV 等格式，所有处理都在你自己电脑上完成。
跑起来只需要满足三条：
- 一台装了微信电脑版并登录过的 Windows 或 macOS 机器
- Python 环境（3.8 以上即可）
- 本机 WeChat Files 目录里已有聊天记录数据库缓存
如果微信电脑版从没在这台机器上登录过，数据库还不存在，后面无从解析。
从克隆到拿到结果的最短路径
四条命令就够了：
git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg pip install -r requirements.txt python3 WeChatMsg.py第三条跑完没有报错，说明依赖装好了。第四条运行后，脚本会提示你选数据库路径和联系人，第一次只挑一个小对话。跑完后，输出目录里出现对应联系人的 HTML 文件就算成功——浏览器打开，能看到聊天气泡布局即可。
数据库路径别手敲，用文件管理器复制完整路径最稳。
导出格式怎么选：我的 4 种场景
四种格式我都用过，选择逻辑很简单：
| 我的场景 | 选择 | 原因 |
|---|---|---|
| 换机前做全量归档 | HTML | 还原聊天气泡样式，随时打开翻看 |
| 写工作总结、打印存档 | Word | 结构规整，方便二次编辑 |
| 统计聊天频次、做分析 | CSV | 一行一条记录，直接拖进表格工具 |
| 只想要纯文字、快速检索 | TXT | 体积最小，任何设备都能打开 |
我换机时的做法是：全量导一份 HTML 归档，另按年份导一份 CSV 专门做统计，两边互不干扰。
年度报告：把一年的对话变成图表
导出只是基本操作，让我觉得值的是年度聊天报告。把一年的记录喂给它，它自动统计消息总量、和你互动最频繁的人、活跃时间段。第一次跑的时候，我算出一个久不联系的朋友一年里和我发了两千多条消息，这个数比翻聊天记录直观得多。
项目作者还在把这类可视化往照片和旅行数据上延伸，报告预览材料在仓库 doc/ 目录里，下面是其中一张报告示意：
我踩过的 3 个坑
- 第一次跑提示找不到数据库：先登录微信电脑版、打开几个对话让缓存落盘，再重试。数据库是登录后才生成的，客户端没跑过，目录里就是空的。
- 全量导出文件特别大：先缩小范围，导出单个联系人或单个年份验证无误，再逐步扩大。别一次硬扛全量。
- 解密环节失败：运行解密那一步时，让微信电脑版保持登录且未关闭。新版本微信的数据库带加密，密钥要从本地进程里取，提前退出登录就取不到。
先从一个最小对话开始
开头说的那层"多出来的文件夹"，现在看恰恰说明它比我想的更扎实：没指定的格式它也按联系人生成好了目录。
门槛最低的一步是这个周末挑个最小的对话跑一遍：克隆仓库、登录微信、选一个联系人。HTML 能正常打开，剩下的全量导出就只是时间问题了。
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
