企业官网建设流程全解析

如何把微信聊天记录永久保存：用 WeChatMsg 导出微信记录的完整实操指南

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

上个月重装电脑，我妈在微信里发我的快递单号彻底找不到了，翻聊天记录也翻不到底。WeChatMsg 是一款开源工具，能读取你本机的微信聊天记录，导出成 HTML、Word、CSV 文档永久保存，还能生成年度聊天报告，全程本地处理。

仓库里还放了一张新版年度报告的设计参考图，卡片式统计加地图视图，可以帮你提前预览微信聊天报告未来的可视化风格：

WeChatMsg 能帮你做什么

先说清楚它的原理：你的微信聊天内容其实一直存放在本机的一个加密数据库里，WeChatMsg（项目代号"留痕"）直接解析这份数据库，把消息变成能阅读、能归档的文档，不需要微信提供官方导出入口。

• 聊天数据不出设备：解析和导出都在你自己的电脑上完成，内容不经过任何服务器
• 开源且免费：MIT 协议公开源码，实现方式可以查，不收费
• 不止一种产出：HTML、Word、CSV 三种导出格式，外加年度聊天报告
• 文件按会话命名：导出的文档以聊天主题命名，归档后按名字就能找到
• 不用手工导出：免去在微信里一条条转发、复制的麻烦，整批处理

开始之前：确认 3 个前提条件 ✅

这一步把环境一次性检查好，后面跑通才不卡壳。确认以下 3 项再开始：

1. 电脑装了 Python 3.8 或更高版本——Python 是程序运行的环境，项目建议 3.8+
2. 本机装过微信并且登录过——工具只读本地数据库，这台机器没登录过就没有数据可读
3. 目标会话的消息已同步到本机——聊天历史需下载过，只存在于云端的消息拿不到

如果是新电脑或刚换过账号，先在微信里打开目标会话、上下翻动几下把历史消息加载出来，再运行工具。

首次成功导出的最短路径 🚀

这一节做三件事：装上项目、跑一次程序、确认导出结果。

装项目与依赖。

git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg python -m venv venv source venv/bin/activate pip install -r requirements.txt

Windows 用户把激活那一行换成venv\Scripts\activate。

运行主程序。

python main.py

首次运行要逐条读取数据库并解析记录，记录量越大耗时越长，让它自己跑完、中途别关窗口即可。

如果目录里找不到main.py别慌：入口文件名各版本可能不同，以 项目 README 里的运行说明为准。

确认导出结果。

find . -name "*.html" -o -name "*.docx" -o -name "*.csv"

Windows 下在命令提示符里改用dir /s *.html可以达到同样效果。

怎么算成功：命令列出了以聊天主题命名的文件，就说明导出完成了。.html双击就能在浏览器里翻阅，.docx用 Word 打开，.csv导入 Excel 就是一张规整的表格。

导出来的文件能干什么 📁

最常见的三种用法，挑一个试。

把聊天变成随时可搜的文档

记录一多，翻聊天记录效率极低，重要的信息（单号、约定时间、行程）全埋在消息流里。导出成 Word 或 HTML 之后直接按关键词搜索，要找的东西立刻定位。

运行python main.py，按提示选中目标会话，导出格式选 Word 或 HTML。

让工具替你算全年互动 📊

年度聊天报告会汇总全年互动量、高频联系人、最活跃时段这些数据，并用可视化页面呈现，一眼看出哪段时间你聊得最多。另外作者在 README 里说明，下一代年度报告会交给新的配套项目实现。

运行python main.py，进入年度报告功能，指定要统计的年份。

把对话装进电子表格

做内容整理或团队复盘时，结构化数据比排版好的文档好加工。导出的表格带发送人、时间、内容等列，在 Excel 里筛选一遍，就能统计高频词、活跃时段。

运行python main.py，选中会话，导出格式选 CSV。

导出格式怎么选 🤔

三条可执行的建议：

• 记录量大时按会话拆成几批导出，单批任务更稳，某一批失败不用重跑其他批
• 先挑两三个小会话走一遍完整流程，熟悉提示之后再处理大群聊
• 导出完成后把结果文件另存一份到移动硬盘或网盘，和微信本地数据库互为备份

常见症状排查手册 🔍

按所处阶段分组，每条都是"现象 → 原因 → 动作"。

安装阶段

• 装依赖时弹加密库相关报错→ 系统缺对应编译依赖，Mac 上较常见 → 按报错提示先装系统级依赖，再重新执行安装命令

运行阶段

• 微信刚更新完就导出失败→ 大版本更新可能改变数据库结构，且项目已处于停更状态 → 先到仓库确认是否有新版本，再排查本机环境
• 一条记录都解析不出来→ 本机没登录过微信，或目标会话消息未同步到本地 → 先登录并打开目标会话让历史消息下载，再重新运行
• 导出很慢，像卡住了→ 记录量大导致耗时长，属正常现象 → 按会话拆分任务，或避开电脑高负载时段

结果处理

• 担心数据安全→ 解析与导出全程在本地完成、不经服务器，需要管理的是导出文件本身 → 别把导出文件放在公共目录

记录归你所有

项目已停更、不会再有新版本，越是珍视的会话越值得现在导出。你可以从最舍不得删的那一段对话开始：今天跑一次导出，把生成的文件放进自己的归档目录，记录早一天落到自己手里，就安心一分。更多背景见 项目 README。

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