微信聊天记录导出WeChatMsg使用指南：从0到1跑通完整流程
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
给新项目交接留档时，最棘手的是把三年的群聊记录完整搬下来。微信聊天记录导出工具 WeChatMsg（留痕）读取微信PC版留在本机的数据库，把对话导出成HTML、Word、CSV三种文档永久保存，还能基于聊天数据生成年度聊天报告。
🎯 一、它能替你解决什么问题
- 把只存在微信客户端里的老对话，变成离线也能打开、能全文搜索的本地文档
- 不用逐条截图存证，直接得到按时间顺序完整排列的Word、CSV档案
- 把加密在本地数据库里的聊天记录，变成通用格式，换设备、换系统都不丢
- 把一整年的聊天数据，变成一份可视化年度报告，看清消息量、活跃时段与情感曲线
需求对上了，把环境搭起来。
📦 二、从克隆到跑通：完整操作步骤
运行前只需确认两件事：电脑装有 Python 3.8 或更高版本，微信PC客户端已登录。装Python时记得勾选 Add Python to PATH。工具读取的是微信本机数据库，所以导出前微信必须处于登录状态。
git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg # 把源码拉到当前目录 cd WeChatMsg && pip install -r requirements.txt # 进入目录并按清单安装依赖依赖装完后，一条命令启动：
python main.py # 启动图形界面启动后是一个图形界面，不需要记任何命令行参数。确认微信PC版窗口保持打开，在界面里选中要导出的联系人或群聊，挑一个格式，点导出，等进度条走完，结果就在输出目录里。第一次建议挑一个消息量不大的群，把整个流程跑通。项目定位与更新说明见 readme.md。
跑通之后，逐个看它能干什么。
🧩 三、核心功能逐项拆解
导出后的文件拿来做什么？取决于用途。WeChatMsg 的核心能力可以拆成三块：多格式文档导出、年度报告、统计与情感分析。
3.1 聊天记录导出：HTML、Word、CSV 三种格式怎么选
工具从微信PC版的本地数据库提取消息文本和媒体文件，导出成三种文档格式。适用场景：取决于这份记录是给谁看、拿来做什么。
- 在图形界面中选中联系人或群聊，格式三选一，同一批记录可重复导出不同格式
- HTML 文件用浏览器直接打开，内置搜索框，能按关键词检索任意一句话
- CSV 中每条消息都是独立字段，丢进 Excel 就能做透视统计
| 格式 | 适合场景 | 特点 |
|---|---|---|
| HTML | 日常浏览、归档检索 | 带搜索和多媒体预览，适合自己翻阅 |
| Word | 整理成文档、打印交付 | 方便二次编辑和排版 |
| CSV | 数据分析、Excel处理 | 结构化字段，适合做统计 |
选型建议：只想留住回忆选HTML；要打印或交付文档用Word；要做数据统计就选CSV。三种格式互不冲突，重要的一次全出。
3.2 年度聊天报告：给一年的社交生活做盘点
把一整年的聊天数据喂给它，会生成一份图文并茂的可视化报告。适用场景：年底复盘，或给某个阶段的社交生活做存档。
- 覆盖消息总量、时间分布、关键词热度、情感趋势等维度
- 报告在本机生成，不经过任何外部服务
- 注意节奏：2025年的年度报告将迁移到作者的AI相册新项目行影集中实现
上图为行影集中年度报告的数据可视化样式，可视为年度聊天报告的参考形态。
3.3 统计与情感分析：让数据自己开口
除了导出，工具还能从记录里提取统计信息。适用场景：想知道自己一年聊得最多的是谁、情绪在哪些时间点波动。
- 识别对话的情感倾向，标记出情绪波动的时间点
- 统计与不同联系人的互动频率和最活跃聊天时段
- 多年数据汇总后，可以观察与某位好友关系的亲疏变化
能力之外，边界也要说清。
⚠️ 四、使用边界与注意事项
- 微信版本兼容有边界。工具依赖特定版本微信的本地数据库结构，3.9.x 系列兼容性最好，升级到新版后可能无法解析。怎么办：保留一个 3.9.x 版本专做导出备份，日常聊天用新版，两者互不影响。
- 大数据量导出会变慢。几千条消息的群导出 Word 时会明显卡顿。怎么办：按年份分批导出，一年一次，既快又方便日后查找。
- 多媒体文件很占空间。连图片、语音一起导，体积会成倍增长。怎么办：先只导文本，需要时再补导媒体文件。
- 微信PC客户端是硬依赖。工具读取的是本机数据库，要求客户端保持登录、窗口未关闭。怎么办：每次导出前先确认登录状态，导出过程中别退出微信。
- 项目更新节奏要知晓。作者近年精力转向新的AI相册项目，暂无大版本计划。怎么办：核心的微信记录本地备份能力至今稳定可用，年度报告等延伸功能可关注作者新项目。
数据安全问题，一并说清。
🔒 五、你的数据去了哪里
- 全程本地处理：解析、导出、分析都在你自己的电脑上完成，断网也能正常跑，数据不出硬盘。
- 代码开源可审计：项目源码完全公开，可以逐行检查它到底做了什么，不存在黑箱上传。
- 导出格式通用：HTML、Word、CSV 都不依赖微信本身，哪怕客户端改版或关停，文件依然能打开。
路线可以很短。
🗺️ 六、落地路径与适用人群
- 装好 Python 3.8+ 和一个老版本微信PC客户端，登录一次
- 克隆仓库并安装依赖（git clone 加 pip install -r requirements.txt）
- 运行
python main.py，启动图形界面 - 挑一个重要的联系人或群，导出 HTML 格式试试水
- 跑通后按年度定期全量备份，再体验一次年度聊天报告
如果你需要把微信记录从客户端里解放出来、长期留在自己的硬盘上，这篇指南适合你。不需要开发背景，会开终端就能跑通。今晚花20分钟先导一个群试试，比等以后强。
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
