WeChatMsg 完整实操指南：免费离线导出微信聊天记录为 HTML、Word、CSV
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
WeChatMsg（留痕）是一款免费开源的微信聊天记录导出工具，直接读取电脑微信桌面版的本地数据库，把聊天记录导出成 HTML、Word、CSV 三种文档。全程在你的电脑本地运行，只读取数据，不改动原始数据库，也不经过任何网络传输。下面这套流程是我实际跑通一遍的路径，照着做即可完成导出。
微信聊天记录导出：这三类人值得做一份备份
- 准备换手机、重装系统的人：动手之前先做一份完整备份，早期聊天记录就不会随旧设备丢丢。
- 想把重要往来变成可检索文件的人：某段对话想长期留存、甚至打印成一册，导出是最直接的路径。
- 想统计自己聊天数据的人：谁消息最多、哪个时段最活跃，先把结构化数据拿在手里再谈分析。
WeChatMsg 运行环境检查
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 或 macOS |
| 微信客户端 | 已安装桌面版，且账号在电脑上登录过 |
| Python | 3.7 及以上版本，安装时勾选 Add to PATH |
一条命令验证 Python：
python --version判定标准：终端打印出 3.7 或更高的版本号即通过。若提示"不是内部或外部命令"，说明 Python 没装好或安装时没勾 PATH，重新安装并勾选即可。
WeChatMsg 安装步骤 📦
整体分三步：克隆源码装依赖、连接微信本地数据、选定对象开始导出。每步都给出了成功判断标准，卡住时按提示排查。
步骤一：克隆 WeChatMsg 源码并安装依赖
目的：把源码拿到本地，装齐运行所需的 Python 依赖。
操作：克隆仓库并进入目录：
git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg创建虚拟环境（把依赖和系统已有包隔离开，互不干扰），再按系统激活对应一条：
python -m venv venvsource venv/bin/activate # macOS / Linuxvenv\Scripts\activate # Windows最后安装依赖：
pip install -r requirements.txt成功判断：安装结束没有红色报错，运行pip list能查到刚装的主包。
出错先看哪里：激活时报"找不到文件"，九成是两套系统的命令用串了，换成本系统对应那条重试；下载速度慢，把 pip 换成国内镜像源重装一次即可。
步骤二：连接微信本地数据
目的：让程序自动找到微信存放在本机的数据库。
操作：
- 先退出微信：把微信桌面版完全退出，托盘里的小图标也要清掉，否则数据库被占用会产生读取冲突
- 启动程序：重新登录一次微信确保数据是最新的，然后退出微信，运行下面的命令
python main.py- 点击连接：窗口打开后点"连接微信数据"，程序自己去寻本地数据库，不用手动指路径
成功判断：连接成功后，界面上的联系人列表从空白变成有数据。
出错先看哪里：提示找不到微信数据，九成是微信没退干净或账号未登录——彻底退出（含托盘图标）后重新登录，再点一次连接。
步骤三：选定对象与格式开始导出
目的：指定导出范围和格式，真正把记录落到磁盘上。
操作：在界面里依次完成三个选择——① 导出对象（某个联系人或群聊）② 时间范围 ③ 文件格式，确认后程序自行完成解析和落盘。
成功判断：导出跑完，保存目录里出现对应文件；HTML 文件用浏览器双击就能打开，排版接近微信原版。
出错先看哪里：记录量很大时建议按时间段拆着导——先导最近一年，再往前推；同时保证内存和磁盘有富余，导出期间别同时跑占资源的大应用。
WeChatMsg 导出产出对比：HTML、Word、CSV
| 产出物 | 适合场景 | 特点 |
|---|---|---|
| HTML | 屏幕回看 | 排版贴近微信原版界面，图片表情正常显示，双击即开 |
| Word | 打印归档 | 可编辑排版、可打印装订，适合做纪念册或归档资料 |
| CSV | 数据分析 | 结构化表格，可直接进 Excel 拉透视表，或用 pandas 二次聚合 |
按目的选就行：想回看选 HTML，想打印归档选 Word，想做统计选 CSV。CSV 拿到后丢进 Excel 做透视表，每个联系人的消息量一目了然。
除了单条记录导出，项目还会把一整年的聊天数据聚合成年度聊天报告，聊天频率、活跃时段都做了可视化：
微信聊天记录导出排错速查
现象：点连接后提示找不到微信数据原因：微信桌面版没完全退出（托盘图标还在），或当前账号未登录处理：彻底退出微信，重新登录，再点一次连接
现象：启动程序直接报 ModuleNotFoundError原因：依赖装到了系统 Python，虚拟环境没有激活处理：先激活 venv，再重新执行一次依赖安装命令
现象：大记录量导出时卡住或中断原因：一次导全量，内存和磁盘被占满处理：按年份或按联系人分批导出，错峰运行
现象：某个群聊的导出结果找不到原因：选择对象时只勾了个人联系人，群聊没勾上处理：回到选择步骤勾上该群，单独补导一次
WeChatMsg 高频疑问速答 ❓
支持手机版微信吗？目前面向电脑版。手机端权限和加密限制较多，不在支持范围内。
导出会动到原始记录吗？不会。全程只读操作，原数据库原样保留，之后微信正常使用不受影响。
群聊能导吗？能。在联系人选择步骤里勾上群聊，该群记录即可整体导出。
需要自己找数据库路径吗？不需要。点"连接微信数据"后程序自动定位本地数据库。
有收费环节吗？没有。项目免费开源，从安装到导出全程不花钱。
写在最后
记录落进自己的硬盘，换手机、重装系统都不慌，需要时再导一次就是了。想了解更多项目说明和示例图，可以看 README 和 doc/ 目录。
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
