WeChatMsg 微信聊天记录导出教程：10 分钟完成首次导出，三种格式永久保存

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

WeChatMsg 是一款免费开源工具，读取微信桌面版本的本地数据库，把微信聊天记录导出为 HTML、Word、CSV 三种本地文件。全程离线、只读，不修改原始数据，也不把任何内容上传到云端。

先给结果：导出来能变成什么

导出完成后，会得到与所选对象一一对应的本地文件，三种格式分工明确：

除三类文件外，项目还能把一整年的聊天数据聚合成可视化的年度聊天报告。

最短路径：从克隆到首次导出

本节把环境验证、克隆、虚拟环境、依赖安装合并为一条主线，每步都给出通过标准。

第 1 步，验证运行环境。要求 Windows 或 Mac 系统，已安装并登录微信桌面版，Python 3.7 及以上且在 PATH 中：

python --version

输出版本号 ≥3.7 即满足要求；低于该版本时，到官网安装新版，安装时勾选 Add to PATH。

第 2 步，克隆源码：

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

目录中出现项目源码，即视为通过。

第 3 步，创建隔离环境。虚拟环境把新装的包与系统已有包分开，避免相互影响：

python -m venv venv

生成 venv 目录即视为通过。

第 4 步，激活环境并安装依赖。两套系统的激活命令不同，按本机选择其一执行：

# Mac / Linux source venv/bin/activate # Windows（在 cmd 或 PowerShell 中执行） venv\Scripts\activate pip install -r requirements.txt

安装过程无红色报错，且pip list中可查到刚安装的主包，即视为通过。激活时若提示找不到文件，说明执行了另一套系统的命令，换成本机对应的 activate 行重跑；下载缓慢时改用国内镜像源重装一次。本地情况与上述命令有出入时，以 readme.md 为准。

最容易卡住的环节：连接微信数据的正确顺序

这一步只解决一个问题：让程序定位到本地数据库。顺序不能颠倒——先彻底退出微信桌面版（托盘图标一并清掉），再重新登录，然后启动程序：

python main.py

窗口打开后点击"连接微信数据"，程序自行寻找本地数据库，无需手动指定路径。

判断标准：原本空白的联系人列表被数据填满、可以翻页浏览，即视为连接成功。若提示找不到数据，说明微信未完全退出或账号未登录，一步修复动作是：彻底退出并重新登录后，再点一次连接。

连接成功后，其余操作在界面内完成：选择导出对象（个人联系人或群聊）、时间范围与文件格式，程序负责解析与写入磁盘，完成后到保存目录核对文件，HTML 可直接双击打开。记录量较大时按年分批：先导最近一年，再往前推，为内存和磁盘保留余量。

数据到手之后：CSV 还能干什么

CSV 文件不要只存着不用，有三种后续用法：

1. 在 Excel 中打开并拉透视表，按联系人汇总消息量，分布情况一目了然。
2. 用 pandas 做二次加工：聚合话题趋势，统计群聊活跃时段。
3. 生成可视化报告：项目支持把一整年数据聚合成年度聊天报告，doc/ 目录内有示例图可对照。

问题自查：症状｜原因｜处理

四个高频问题，一行一个答案

• 手机版微信能用吗：目前只面向电脑版，手机端受权限与加密限制，不在覆盖范围。
• 导出过程会改动原始数据吗：不会，全程只读，原库保持原样，导出期间微信照常可用。
• 群聊记录能整体导出吗：能，在联系人选择步骤勾选对应群，该群记录整体导出。
• 过程中有收费环节吗：没有，项目免费开源，从安装到导出均不产生费用。

记录以本地文件形式留存之后，换设备、重装系统都不必担心数据丢失——重新执行一次导出，记录始终掌握在自己手里。

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