3 步完整导出微信聊天记录:WeChatMsg 快速上手指南
【免费下载链接】WeChatMsg提取微信聊天记录,将其导出成HTML、Word、CSV文档永久保存,对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
WeChatMsg 是一款开源的微信聊天记录导出工具,它解密电脑上的本地微信数据库,把多年对话完整转成 HTML、Word、CSV 三种文档,还能汇总出年度聊天报告。下文按"原理 → 定位 → 可靠性 → 安装速查"的顺序,把它拆开讲清楚。
它是怎么工作的:核心原理一览
整个流程可以概括为三个阶段:从内存中取密钥 → 把数据库翻译成消息 → 渲染成目标文档。
输入:微信加密数据库的解密读取
- 微信 PC 版把全部会话写在本地的消息库文件
EnMicroMsg.db里,位置在 WeChat Files 或 xwechat_files 数据目录下 - 该文件采用 SQLCipher 加密,可以理解为"带密码锁的 SQLite 文件",直接双击是打不开的
- 打开它的密码不保存在任何文件里,而是随着微信进程驻留在内存中——这就是"导出前必须保持微信登录"的原因
- 工具先扫描进程内存定位密钥,再用它打开数据库,解密后得到标准的"一条消息一行"的表结构:时间、发送人、类型、内容各占一列
转换:消息类型到可读文档的映射规则
- 库里存的是类型编号(文本、图片、语音、视频、链接、系统提示等),并不是现成的文字
- 工具内置一张类型映射表,把编号逐条翻译成可读内容:文字原样保留,图片、语音、视频则从微信附件目录拷贝出对应文件
- 系统类消息被处理成居中的分隔说明,读起来类似聊天窗口里的时间提示
- 导谁的会话、用哪种格式,都写在
config.yaml里,同一份配置重复运行结果一致
输出:HTML、Word、CSV 三种导出格式
- HTML:仿照聊天气泡排版,图片直接嵌入,适合在浏览器里长期翻看和检索
- Word:把对话变成可打印、可装订的纸质档案,归档场景友好
- CSV:纯表格结构,导入 Excel 就能自己写公式做统计
- 同一批数据还可以再聚合一层,产出年度聊天报告:全年消息总量、聊得最多的人、年度首条与末条消息等维度 📊
为什么需要它:痛点与工具定位
- 官方通道缺席:微信始终没有提供"导出全部聊天记录"的功能,换新设备或给旧对话归档时,用户没有任何官方路径可用
- 人工手段扛不住:逐条截图不仅耗时巨大,得到的还只是一堆无法搜索、无法统计的图片
- 真正的门槛在加密层:聊天记录被锁在本地加密数据库里,密钥又不在磁盘上,想直接拷走文件用表格软件打开的常规做法在这里行不通
- WeChatMsg 的路线:从微信进程内存取密钥、解密数据库、渲染文档,全程在本机完成,数据不离开你的电脑,与开头提到的"本地导出"相互印证
可靠性:可以放心的点
- 数据不出门:解密、读取、生成文档每一步都在你自己电脑上执行,没有任何上传云端的环节
- 流程可复现:密钥与数据库目录都固化在
config.yaml中,换个时间重跑,同一配置产出同样的结果 - 失败不装傻:密钥对不上、微信升级导致表结构变化时,工具会在读取阶段直接抛出错误,不会偷偷交出一半缺内容的文件
- 口径可核对:导出内容以数据库行记录为唯一基准,抽任意一条去会话历史里比对都能对上
上手实践:安装与运行速查
前提条件:Windows 系统、保持微信 PC 版处于登录状态、本机已安装 Python 3.8 及以上版本。
git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg # 克隆项目 cd WeChatMsg pip install -r requirements.txt # 安装运行依赖 python wechatmsg.py -k # 第1步:从微信进程获取数据库密钥 python wechatmsg.py -C # 第2步:交互式配置导出参数 python wechatmsg.py -e # 第3步:导出 HTML / Word / CSV参数速查:
| 参数 | 作用 |
|---|---|
-k | 获取数据库密钥(微信必须保持登录) |
-C | 交互式写入密钥与导出格式等配置 |
-e | 按配置执行聊天记录导出 |
-R | 生成年度聊天报告 |
收尾:一句话总结与延伸阅读
一句话概括:WeChatMsg 把电脑里加密的微信消息库,变成可随时打开、检索和打印的 HTML、Word、CSV 文档与年度报告,而数据始终留在本地。
延伸阅读:
- 项目理念与背景说明,见 readme
- 年度报告等效果预览素材,位于 doc/ 目录
- 微信版本不同会导致数据目录结构有差异,遇到异常先核对微信版本,再重新执行密钥获取步骤 🔑
【免费下载链接】WeChatMsg提取微信聊天记录,将其导出成HTML、Word、CSV文档永久保存,对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考