WeChatMsg微信聊天记录导出指南：从克隆仓库到CSV导出只需5分钟

WeChatMsg微信聊天记录导出指南：从克隆仓库到CSV导出只需5分钟

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

WeChatMsg是一款免费开源的微信聊天记录导出工具，它读取微信PC版的本地数据，把聊天记录导出为HTML、Word、CSV文件，并能生成年度聊天分析报告，全程在本地离线完成。

这是什么：WeChatMsg微信聊天记录导出工具

微信官方客户端只提供"迁移聊天记录"功能，属于设备间转移，不会生成可独立打开的文件，长期归档、打印和统计分析基本要手工逐条复制。WeChatMsg是一个基于Python的桌面工具，思路很直接：读取微信电脑版产生的本地数据文件，解析成结构化记录，再转换成你能直接用电脑打开的文件，所有处理都发生在你的机器上。

核心卖点有三个：

• 三种输出格式：HTML适合浏览，Word适合打印，CSV适合数据分析
• 年度聊天报告：按自然年统计消息量、活跃时段和联系频次
• 完全本地离线：数据文件不经过网络，代码以MIT协议开源

核心功能：聊天记录导出格式与年度报告

多格式导出。输入是微信PC版的本地数据文件，输出是按联系人整理的聊天记录。HTML页面保留消息结构，适合日常翻阅；Word文档可直接排版打印；CSV是固定列的表格（时间、发送者、消息内容等字段），能直接导入Excel或pandas做统计。

年度聊天报告。输入一整年的聊天记录，输出包含消息数量、活跃时段、与不同联系人沟通频次的统计报表，适合年末回顾。

定期存档。把CSV导出配合系统定时任务，可以周期性导出新增记录，逐步建立一份持续更新的个人聊天数据库。

快速上手：WeChatMsg导出步骤

开始前先确认电脑装有Python 3.8及以上版本，在终端运行 python --version 查看版本号，未安装请从Python官网下载安装。

第一步，把项目克隆到本地目录，耗时取决于网速，通常1分钟以内：

git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg

第二步，创建虚拟环境隔离依赖，激活成功后命令行开头会出现 (venv) 前缀。Windows用户激活命令为 venv\Scripts\activate：

python -m venv venv source venv/bin/activate

第三步，安装依赖，看到 "Successfully installed" 及包列表即表示完成：

pip install -r requirements.txt

第四步，启动程序，随后登录微信电脑版，按界面指引读取本地数据，选择联系人和时间范围，把记录导出到指定目录。若仓库入口文件名与下方不同，以仓库内说明为准：

python main.py

最常见的报错是 ModuleNotFoundError（找不到模块），原因几乎都是虚拟环境未激活——重新执行第二步的激活命令，再重装依赖即可。

原理与隐私：数据不离开本机

微信电脑版把聊天数据以本地文件形式存在磁盘上，WeChatMsg以只读方式读取这些数据，解析成结构化记录后转成三种输出格式。三个关键事实：

• 全程离线：导出不需要联网，数据文件不会上传到任何服务器
• 只读处理：不修改、不删除源文件，建议先退出微信电脑版再读取，避免文件被占用
• 可审计：代码以MIT协议开源，完整代码在仓库内，可自行确认数据流向

需要说明的一点：项目README写明其已长期未活跃更新，对最新版微信电脑版的兼容性没有保证，首次使用建议先选一个较短的时间范围试导出验证。

适用场景建议：按需选功能

• 如果你想长期备份聊天记录，建议用CSV导出，把文件放进移动硬盘等外置目录定期更新
• 如果你想做可打印的纪念册，建议用Word导出，选定联系人和时间范围后直接排版打印
• 如果你想分析沟通规律，建议用CSV配合Excel或pandas，按月统计消息频次和活跃时段
• 如果你想做年度总结，建议使用年度聊天报告功能，直接输出全年统计页

常见问题：导出失败怎么处理

能读取微信手机版的数据吗？目前只支持电脑版。手机端受系统权限和加密限制，需先用微信自带的迁移功能把记录同步到电脑，再用本工具导出。

启动后提示读不到数据怎么办？先完全退出微信电脑版再重试；仍失败通常是微信版本与工具不兼容，因为项目长期未更新，建议先在仓库的issues区确认对应版本的支持情况。

图片、语音等媒体导出后还在吗？文本消息会完整保留，媒体内容取决于本地存储与所选格式。要保证媒体完整，建议同时用微信自带备份功能留一份原始数据。

数据量大导出很慢？记录量在百万条级别时，按时间分段导出（每年一个文件或每个联系人一个文件），导出期间关闭其他大量读写磁盘的程序。

和微信自带"迁移聊天记录"有什么区别？自带迁移只在设备间转移记录，不生成可独立打开的文件，也无法统计分析；WeChatMsg输出的是可随时离线打开、归档和二次处理的HTML/Word/CSV文件。

WeChatMsg的定位很克制：本地读取、三种格式导出、生成年度报表，数据始终留在你自己的电脑上。如果你的微信里已有值得归档的记录，下一步就是克隆仓库，把第一次试导出跑通。

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