微信聊天记录导出完整指南：十分钟拿到永久HTML存档-编程实验室

微信聊天记录导出完整指南：十分钟拿到永久HTML存档

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

换手机、重装系统、旧手机存储被回收，等你想翻一段对话时，往往发现找不回来了。微信自带备份只能在同设备恢复，备份包一旦脱离环境就是废数据。开源项目**留痕（WeChatMsg）**干的就是这件事：从电脑端微信提取微信聊天记录，导出成 HTML、Word、CSV 三种通用格式，解析全部在你自己的电脑本地完成，不上传云端。

动手前，先核对这四项

检查项	达标标准
电脑端微信	已安装最新版且处于登录状态，非手机模拟环境
记录同步	手机微信「设置→通用→聊天记录备份与迁移」中，目标会话已迁移到电脑，电脑微信能直接翻到这段对话
Python 环境	Python 3.9 及以上，命令行输入`python --version`能看到版本号
磁盘空间	至少 2GB 空闲，存放导出的 HTML、图片与附件

四项都能打勾再往下走，缺哪一项，后面就会卡在哪一步。

十分钟看到结果：走最小验证路径

全量操作之前，先花十分钟把最短路线跑一遍：

手机微信只迁移「最近一周」的记录到电脑。
克隆留痕、装依赖、启动工具（对应下面两个里程碑）。
选一个活跃的小联系人，时间范围一周，格式 HTML，点导出。

拿到一个能双击打开、对话完整的 HTML 文件，整条链路就通了。先保证这十分钟跑通一次，再谈全量。

⚠️ 首次运行别选群组或全量：范围太大既慢，失败了你也定位不了问题出在哪。

主流程：从同步到存档的三个里程碑

里程碑一：把手机记录迁到电脑微信

本步目标：拿到电脑微信目录下的本地数据库文件，这是后续一切提取的原材料。
具体操作：手机与电脑登录同一微信账号，手机微信进入「设置→通用→聊天记录备份与迁移」，选“迁移到电脑”，只勾「最近一周」。
完成信号：电脑微信里能直接翻到刚迁移的对话，内容完整无缺条。

里程碑二：克隆留痕，启动电脑端微信记录提取工具

本步目标：程序成功读到上一步的数据库，进入可导出状态。
具体操作：终端执行git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg，进入项目目录，按使用说明安装依赖并启动程序。
完成信号：界面列出你最近有聊天的联系人与群组，会话条数和微信会话列表对得上。

里程碑三：导出第一份 HTML 存档

本步目标：完成一次微信聊天记录导出 HTML 流程，拿到可双击打开的档案。
具体操作：导出界面选中一个联系人，时间范围设为最近一周，格式选 HTML，保存目录指定一个空文件夹，点击导出。
完成信号：目标目录出现 HTML 文件，打开后对话按原始顺序呈现、无缺条。

跑通之后：今天就能做的三个进阶用法

真实场景：年底想回顾这一年和谁聊得最多、哪个时段最活跃。对应功能：选择“生成年度报告”，工具自动统计聊天频率、活跃时段与高频词，产出一份微信年度聊天报告。今天就能做的动作：勾选全年范围生成一次，一分钟拿到可分享、可存档的图文报告。
真实场景：想弄清自己的时间到底花在哪些对话上。对应功能：导出 CSV 结构化表格，导入 Excel 或 WPS 即可筛选、透视。今天就能做的动作：按联系人透视一次，再按月份筛选一次，规律会自己冒出来。
真实场景：项目复盘只想要某个群最近三个月的对话，不想翻整个聊天库。对应功能：按群组加自定义时间范围定向提取，电脑端微信记录提取可以精确到某一天。今天就能做的动作：复盘前先定向导出那一段，把取用成本降到零。

报告页面示例可翻一下 doc 目录。

避坑：最常踩的三个

现象	原因	一句话解法
工具启动后联系人、会话列表全空	电脑微信未登录，或手机记录没同步到位	回里程碑一补同步，确认电脑微信能翻到那段对话
HTML 能打开，但顺序错乱、消息缺条	导出目录混进旧文件，或导出中途被手动终止	换空目录重新导出，导出完成前别关程序
全量导出进行到一半卡死	一次处理记录量过大，内存吃紧	按月分段导出，做完再归档合并