WeChatMsg 教程：4步导出微信聊天记录为HTML、Word、CSV并生成年度报告-编程实验室

WeChatMsg 教程：4步导出微信聊天记录为HTML、Word、CSV并生成年度报告

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

WeChatMsg（留痕）是一款开源的微信聊天记录导出工具：它读取本地聊天数据库，把对话转成 HTML、Word、CSV 文档永久保存，还能汇总出年度聊天报告。如果你是 Windows 用户、日常使用微信 PC 版，跟着本文 4 步操作即可拿到第一份导出结果。

微信聊天记录为什么难保存

想换手机之前把几年对话带走，大多数人卡在这一步：微信官方没有提供"导出全部记录"的入口，逐条截图存档既繁琐，得到的图片又没法检索和统计。真正的障碍在更底层——微信 PC 版把所有会话存在本地一个上了锁的数据库里（SQLCipher，即加密版 SQLite），钥匙不落在磁盘上，只随微信进程运行存在于内存中。"复制文件直接打开"的思路因此行不通，而 WeChatMsg 的路线是先从运行中的微信拿到钥匙、再打开数据库，整个过程都在你自己的电脑上完成。

微信聊天记录导出原理：4步看懂它怎么做到 📦

第一步：从微信进程内存里取密钥

输入是已登录的微信 PC 版，程序扫描运行中的微信进程，把数据库密钥从内存中提取出来写进配置——这是全部流程的前提，微信没登录这一步必然失败。

第二步：解密本地数据库

拿密钥打开微信数据目录（WeChat Files 或 xwechat_files）中的加密数据库文件 EnMicroMsg.db，解锁后读出标准 SQLite 表格：一行一条消息，时间、发送者、类型、内容各占一列。

第三步：把类型编号翻译成可读内容

每条消息在库里只有一个类型编号（文本、图片、语音、链接、系统提示等），WeChatMsg 用内置映射表反查：文本原样输出，图片、语音、视频从附件目录拷贝对应文件替换进去，系统提示显示为居中分隔说明。导出哪些会话、输出什么格式，由 config.yaml 决定，同一组参数重复运行结果一致。

第四步：输出三种文档与年度报告

同一份数据按不同形态落地：HTML 贴近聊天气泡的阅读方式且支持站内检索，Word 便于打印归档，CSV 是纯表格、可导入 Excel 做自定义统计；按年度聚合后，还能得到全年消息总量、年度第一条与最后一条消息等维度 📊

安装与运行 WeChatMsg：从克隆到首次导出

前置条件清单：

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 # 从微信进程获取数据库密钥 python wechatmsg.py -C # 交互式写入密钥、导出格式等配置 python wechatmsg.py -e # 按配置导出聊天记录 python wechatmsg.py -R # 生成年度聊天报告（可选）

参数速查：

参数	作用
`-k`	获取数据库密钥，微信需处于登录状态
`-C`	交互式配置密钥、输出格式等导出设置
`-e`	按配置导出 HTML / Word / CSV
`-R`	生成年度聊天报告

常见报错与解决办法 🛠

取密钥失败或密钥不匹配：多因微信未登录或密钥取自旧的登录会话；重新打开微信登录，再执行-k重新获取即可。
提示找不到 EnMicroMsg.db：微信新版调整了数据目录结构（WeChat Files 与 xwechat_files 并存）；先定位实际路径，再在 config.yaml 中修改数据库目录。
读取阶段直接报错：通常是微信版本与工具期望的数据结构对不上；不要硬导出半份文件，先核对微信版本、把工具更新到对应版本再重跑。
导出的范围或格式不对：多为-C配置没改到位；重新执行-C调整会话与格式，再跑-e。