30分钟跑通：WeChatMsg把微信聊天记录导出成3种文档，还能生成年度报告-平芜编程栈

30分钟跑通：WeChatMsg把微信聊天记录导出成3种文档，还能生成年度报告

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

准备把旧手机转送人、正要清理微信账号，你忽然意识到：三年的项目群、父母发的叮嘱，现在删掉就永远没了。WeChatMsg 是一款开源的微信聊天记录导出工具，它直接读取你电脑上的微信数据库，把内容导出成 HTML、Word、CSV 三种文档，还能汇总出年度聊天报告。零编程基础的人，也能把记录永久留在自己的电脑里。

先花 20 秒自测：这篇文值不值得你读

📌 读正文前，对照这 3 条打勾：

你电脑（Windows 或 Mac）上装着微信，想把它里面的记录留下来；
你会打开终端、粘贴命令、按回车（就 3 条，不用敲字）；
你有 30 分钟，磁盘还剩几 GB 空闲。

三条全中，往下看；一条都不中，也不用慌，第 2、3 步有人陪着做一遍就能过。

动手之前：3 种保存方式，哪种值得选

同样是为了留住聊天记录，常见的做法有三种，放在一起看差别就出来了：

对比维度	微信官方备份	截图手动存档	WeChatMsg 本地导出
保存形态	跟随账号和设备走	手机里一堆零散图片	独立文件，双击就能打开
时间成本	中，且要卡在迁移窗口里	高，靠手点，难坚持	首次 30 分钟跑完全流程
可检索性	只能在微信界面里搜	基本没法搜	按时间范围、全文筛选
数据归属	同步要经手服务器	存在别人家的设备上	全程留在自己的硬盘
二次利用	没有	没有	CSV 表格可直接丢进分析工具

一句定位：官方备份管"换机还找得到"，截图是纯体力活，WeChatMsg 管的是"记录变成属于我的文件"。

环境准备：两样东西，三条命令

第一样：Python 3.7 及以上。Python 是这套工具运转的"发动机"（一门编程语言，工具靠它跑起来）。去 Python 官网下载对应系统的安装包，安装时勾上 "Add to PATH"（作用是把 Python 登记进系统命令清单，之后终端里才能直接调用它）。装完在终端敲python --version，出现 3.7 开头的数字就合格。

第二样：项目本体和依赖组件。在终端里依次粘贴这三条：

git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg pip install -r requirements.txt

第一条把项目下载到电脑，第二条进到项目文件夹，第三条按清单装齐运行所需的组件（requirements.txt就是"该装什么、装什么版本"的清单文件）。嫌下载慢，可以先把 pip 换成国内镜像源再执行第三条。

从数据库到文档：4 步完成第一次导出

第 1 步：把微信彻底退掉

操作：Windows 上右键系统托盘里的微信图标选"退出"；Mac 上确认 Dock 栏的微信图标已经消失。理由：微信开着的时候，数据库文件是被锁住的状态，此时拷出来多半是个坏文件。验证点：打开任务管理器（Windows）或活动监视器（Mac），确认里面没有任何微信进程。

第 2 步：找到存放记录的 Msg.db 文件

操作：聊天内容实际存在一个叫Msg.db的单一文件里，按系统去对应位置找：

Windows：C:\Users\用户名\Documents\WeChat Files\里以你账号命名的文件夹内
Mac：~/Library/Containers/com.tencent.xinWeChat/Data/Library/Application Support/com.tencent.xinWeChat/里以你账号命名的文件夹内

路径层级很深，直接在资源管理器搜索框里输Msg.db是最快的办法。理由：这个文件是所有聊天内容的唯一来源，找不到它，后面全白搭。验证点：文件体积明显大于 0，修改时间在最近活跃期内。

第 3 步：把数据库复制进项目目录

操作：把Msg.db复制到 WeChatMsg 项目目录下。理由：原件留在原地当底线，副本出了任何问题都有退路。验证点：两个文件的字节大小完全一致。

第 4 步：界面里指认文件、挑格式、按导出

操作：启动 WeChatMsg，在界面里依次完成 4 件事：

指向刚复制好的Msg.db；
圈定范围：全部会话，或只挑几个联系人；
选格式：HTML、Word、CSV 三选一；
设定时间范围，点导出。

理由：首次别贪多，拿一个无关紧要的会话试跑，跑通再上全量。验证点：界面提示完成，项目目录里出现新的文件或文件夹。

三种格式的定位不一样：HTML 做的界面和微信同款，图片直接可见，适合翻着看和存档；Word 方便排版、加批注、打印，适合工作场合；CSV 是结构化的表格数据，适合丢给程序分析。存着看选 HTML，要打出来选 Word，要算数据选 CSV。

导出之后：核对产物，3 招确认能用

导出结束不等于任务完成，花两分钟验一遍：

浏览器打开 HTML：界面长得像微信聊天，上下滚动消息连贯、图片能显示；
Word 文档翻到开头和结尾各看 5 条：时间和内容和你记忆对得上；
Excel 打开 CSV：时间列连续、没有错行的乱码。

✅ 三项都通过，这份档案就算立住了。顺手看一眼文件体积：纯文字应该很小；如果大得离谱，说明把图片视频也存进去了，属正常现象。

导出之后：让聊天记录多干点活

年度聊天报告。除了存文档，这个项目还能对记录做分析，按聊天频率、互动对象、活跃时段等维度拼出一份年度总结，适合年末回看。项目思路见 readme.md：数据先属于你，玩法才多。

拿 CSV 练手。导出的表格就是现成数据集，下面 6 行代码能算出"你平时和谁聊得最多"：

import pandas as pd df = pd.read_csv("导出的聊天记录.csv") top = df.groupby("sender").size().sort_values(ascending=False).head(5) print(top)

这段代码在干什么：读入导出的表格，按"发送者"一栏把消息条数分组累加，再倒序排出前 5 名打印出来。表头列名以你实际导出的文件为准，对不上就把"sender"换成真实列名。

数据可视化的方向。聊天数据跟位置等其他数据源结合后，能长成下面的样子——年度走了多少公里、到过哪些城市、在路上待了多久，一图摊开：

这些留在本地的原始记录，日后可喂给你个人的 AI，让它成为真正了解你的助手——数据为你服务，而不是反过来。

排错速查表：现象、原因、处理

现象	原因	处理
数据库复制失败，或大小对不上	微信没退干净，文件被占用	彻底退出、查进程列表后再拷
导出内容比记忆少一截	源文件只拷了部分，或时间范围设窄	核对源文件完整性，放宽时间范围重导
HTML 能打开但图片不显示	图片资源没有随记录一起导出	检查导出位置有无配套图片目录，一并补齐
装依赖那步报错	Python 版本太旧或 pip 过期	升级到 3.7+，先执行`pip install -U pip`再装
导出很慢、机器发烫	全量记录里媒体文件太多	先跑短时间段的小样，再决定要不要全量