WeChatMsg｜微信聊天记录导出与多格式转换实战指南：从跑通到年度报告

WeChatMsg｜微信聊天记录导出与多格式转换实战指南：从跑通到年度报告

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

重装系统后发现三年的聊天记录没了？微信自带的入口既不能自由导出、格式也不可控。WeChatMsg 解决的就是这个聊天记录导出难题：把电脑端微信的聊天库在本地解析出来，转成 HTML、Word、CSV 永久保存，还能做年度统计分析。

先搞清它能干什么（功能速览）

📌 用几条 bullet 把能力边界说清楚，避免抱着错误预期上手：

• 三种格式导出：HTML 还原聊天窗口观感，Word 可直接打印编辑，CSV 一行一条记录方便做统计
• 本地化解析：解密、解析、渲染全流程在自己的电脑上完成，聊天数据不出门，不经过任何第三方服务器
• 媒体消息留存：不止纯文本，图片等媒体类消息也会随导出保留在输出目录（具体消息类型覆盖面以仓库版本为准，待验证）
• 年度聊天报告：对全年聊天量、高频联系人等做聚合，生成可视化报告
• MIT 协议开源：免费使用，导出模板和统计逻辑都可以自己改

5 分钟跑通：从克隆到第一次出结果

环境要求，先对照一遍：

• Windows 或 macOS（工具解析的是微信桌面端数据，纯手机端环境不适用）
• 已安装并登录微信桌面客户端
• Python 3 环境，建议 3.9 及以上
• 预留磁盘空间：聊天记录越久，导出体积越大

按顺序敲下面的命令：

# 克隆项目到本地 git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg # 进入项目目录 cd WeChatMsg # 安装依赖 pip install -r requirements.txt # 运行主脚本（入口文件名以仓库实际为准，通常类似 wechatmsg.py，待验证） python wechatmsg.py

预期结果：脚本会在本地走一遍扫描数据库、解析、生成的流程，结束后项目目录下出现输出目录（常见为html目录），里面是按会话分好页的聊天页面和媒体文件（具体目录结构待验证）。打开任意一个 HTML 文件，看到接近原始聊天窗口的排版，就算跑通了。

它到底怎么做到这件事的

先讲数据流：微信桌面版把聊天内容存在本地的加密数据库里，工具的第一步就是定位这些数据库文件；第二步解密并解析成结构化记录——发送人、时间戳、消息内容、媒体文件路径；第三步按目标格式渲染输出。HTML 走"还原界面"路线，Word 走"文档化"路线，CSV 则只做最朴素的表格式落盘。

为什么直接读数据库而不是截屏或调接口？因为数据库里是完整原始记录，一次批量读完，不干扰正在运行的微信客户端，也不会漏消息。而"本地处理"不是营销词，是隐私上的硬约束：聊天记录属于最私人的个人数据，上传到任何云端都是风险，本地解析同时还是最快的路径——省去了网络传输环节。

进阶玩法：格式选择与自动化

选对格式：三种导出各适合什么场景

💡 一个常用组合：平时用 HTML 存档，同时导出一份 CSV 留作数据底稿，多格式聊天数据备份的成本很低。

定时自动备份

手动导出一次容易，坚持每年导出才难。用 Python 的schedule库写个定时任务，每月或每季度跑一次全量导出：

# 每周日凌晨 3 点自动执行一次导出 import subprocess import schedule import time def backup_wechat(): # 入口文件名以仓库实际为准（待验证） subprocess.run(["python", "wechatmsg.py"]) schedule.every().sunday.at("03:00").do(backup_wechat) while True: schedule.run_pending() time.sleep(60)

Windows 用户也可以把python wechatmsg.py直接丢进任务计划程序，效果一样。

把聊天数据喂给年度报告

项目 readme 里写得很直白：2024 年度报告已经实现，2025 年度报告将迁移到作者的行影集项目中落地，形态大致如下图这种可视化风格（细节以 readme.md 为准）：

图：行影集项目的可视化报告界面（旅行足迹报告页），2025 年度报告将在此落地

对想玩深的人来说，导出的 CSV 本身就是现成的数据集：谁陪你聊得最多、你几点最活跃、哪个月是聊天高峰，写几行 pandas 就能算出来。

横向对比：它和替代方案差在哪

定位一句话：官方迁移适合"换新设备"，SaaS 适合"不想动手"，而 WeChatMsg 面向的是想把数据握在自己手里、且随时能用任意软件打开的人。

避坑指南：你大概率会遇到的问题

⚠️ 容易忽略的细节一：仓库 readme 明确写着项目"很久没有（也不会）更新"，微信客户端一旦大版本升级导致数据库结构变化，工具可能直接失效。第一次跑通后就留一份完整导出，别等要用时才发现工具已不能用了。

⚠️ 容易忽略的细节二：导出内容的上限就是本地数据库的内容。纯手机上聊的、从未同步到 PC 的记录不在导出范围内，别拿它当作手机记录的完整备份。

写在最后

WeChatMsg 的价值可以压缩成一句：免费、本地、导出的格式永远打得开，聊天记录从此真正留存在你手里。

接下来两件事值得做：一是把上面的定时脚本挂起来，让备份变成习惯而不是决心；二是有 Python 基础的话，直接改导出模板或基于 CSV 写个小统计脚本，比如算算自己深夜聊天的频率——数据已经在你手里了，玩法自己定。

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