微信聊天记录导出完整指南：15 分钟把多年记录落到本地

微信聊天记录导出完整指南：15 分钟把多年记录落到本地

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

WeChatMsg 是一款免费开源工具，离线读取微信桌面版的本地数据库，把微信聊天记录导出成 HTML、Word、CSV 三种文件。全程在你自己电脑上运行，只读、不联网，没有一字上传云端。

如果你的情况是——换设备，好几年前的记录从没备过份，手机一换就没了着落；做归档，想把和某人的往来变成能检索、能打印的文件；看数据，想知道一年里跟谁聊得最多、哪个时段最活跃。这几件事的入口都是同一个——把数据落到自己硬盘上。

环境检查：系统与 Python 版本

一条命令验证：

python --version

版本号在 3.7 及以上就算通过；低于它先去官网装新版，安装时勾上 Add to PATH。

速查：全流程命令

只想抄完收工的，对着这段敲，注意两套系统的激活命令不一样。

git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg python -m venv venv # Mac / Linux source venv/bin/activate # Windows（cmd 或 PowerShell 里单独执行） venv\Scripts\activate pip install -r requirements.txt python main.py

下面把每一步拆开讲：走到哪一步、怎么算成了、卡住了查哪。

克隆 WeChatMsg 源码，搭虚拟环境

目标：把源码弄到本机，依赖装进虚拟环境——新装的包和系统里已有的各管各的，互不干扰。

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。

确认成功：装完没有红字报错；在激活后的环境里敲pip list，能翻到刚装的主包。

失败时：激活提示"找不到文件或目录"，九成是把另一套系统的激活命令串过来了——换成本系统的命令重跑；下载慢就换国内镜像源重装一次。

依赖就位，接下来轮到数据端。这一步顺序最讲究，别乱。

退出微信，连接微信本地数据

目标：让程序找到并连上微信的本地数据库。

先把微信桌面版彻底退出——系统托盘里那个小图标也算退出——重新登录，再启动程序：

python main.py

窗口打开后点"连接微信数据"，程序自己去找本地数据库，不用手动指路径。

确认成功：原本空白的联系人列表里出现了名字，能上下翻动看。

失败时：提示找不到数据，多半是微信没退干净或当前账号没登录——彻底退出、重新登录，再点一次连接。

联系人能看见了，剩下的就是告诉程序导谁、导成什么。

选定联系人与格式，确认聊天记录导出

目标：指定导出对象、时间范围和文件格式，解析与写盘交给程序。

这步不用敲命令，全在窗口里点：勾选导出对象（个人联系人或群聊），设时间范围，选文件格式，确认，等进度走完。

确认成功：保存目录里出现与所选对象一一对应的文件；双击 HTML，浏览器里图片、表情显示正常，排版和微信里几乎一致。

失败时：记录量大跑到一半卡住，别一把梭——先导最近一年，再逐年往前推，给内存和磁盘留点余量。命令或本地情况与本文有出入时，以 readme.md 为准。

产出对比：HTML、Word、CSV 各管什么

一句话记：HTML 管看、Word 管印、CSV 管算。

验证结果没白跑：文件个数对照所选对象数；打开 HTML，抽头尾几条消息和微信里比对；CSV 用 Excel 打开，时间、发送人、内容三列齐整。CSV 别扔——拉个透视表，每个联系人的消息量一目了然。

问题排查：四个高频症状

常见问题

支持手机版微信吗？

目前只面向电脑版。手机端权限和加密限制多，不在范围内。

导出会动到原始记录吗？

不会。全程只读，原数据库原样留着，导出期间微信照常能用。

群聊能导吗？

能。选择对象那一步勾上群，该群的聊天记录整体导出。

有收费环节吗？

没有。项目免费开源，从安装到导出每一步都不花钱。

记录安稳躺在自己硬盘里之后，换设备、做归档、看数据都不慌了——再导一次就是了。

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