企业官网建设流程全解析

WeChatMsg 微信聊天记录导出实操：离线、只读，一次跑通 HTML/Word/CSV

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

WeChatMsg（项目名"留痕"）是一个免费开源的微信聊天记录导出工具：直接读取微信桌面版在本机的数据库，把历史消息导出成 HTML、Word、CSV，还能聚合成年度聊天报告。全程离线运行、只读不写，原始数据一个字都不碰。下面这条路径我自己实际跑通并验证过一遍，重点都标出来了。

什么情况值得花时间导出

• 如果你正打算换手机、重装系统，担心早期聊天记录跟着环境一起丢，先做一份完整备份最稳。
• 如果想把和某个人的重要往来变成可检索的本地文件，或者干脆打印成一册留档，导出是最短路径。
• 如果想统计自己的聊天数据——谁消息最多、哪个时段最活跃——先把结构化数据拿在手里，再谈分析。
• 如果每年想回顾一次自己的社交状态，项目自带年度聊天报告，把频率、时段、高频内容做成可视化。

开工前 10 分钟：环境检查

一条命令验证 Python：

python --version

看到形如Python 3.10.x的版本号就算通过；如果低于 3.7，去 Python 官网装新版，安装器里勾上 Add to PATH 再重开终端。

执行主线：四步把记录搬进本地文件

第 1 步：克隆仓库，隔离依赖

做什么：拿到源码，建一个虚拟环境装依赖，避免和系统里已有的 Python 包互相打架。

git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg python -m venv venv

激活虚拟环境（两套系统命令不同，各选一条）：

source venv/bin/activate # macOS / Linux

venv\Scripts\activate # Windows

pip install -r requirements.txt

成功标志：安装过程没有红色报错，pip list里能查到刚装的主包。出错先看哪里：激活时报"找不到文件或目录"，基本是 Windows 和 Mac 的命令用串了；下载慢就临时换国内镜像源重装一次。

依赖装好后，下一步就要让程序找到你的微信数据。

第 2 步：彻底退出微信，再启动程序

做什么：数据库文件在微信运行时是被占用的，所以连接前先把微信桌面版完全退出——包括托盘/状态栏里的小图标。重新登录微信后，在仓库目录下运行：

python main.py

窗口打开后点界面上的"连接微信数据"，程序会自己去定位本地数据库，不需要手动指路径。

成功标志：连接提示成功，联系人列表从空白变成有数据。出错先看哪里：提示找不到数据时，九成是微信没退干净或账号掉线了——彻底退出（含托盘图标）、重新登录，再点一次连接。

第 3 步：选对象、选范围、选格式

做什么：在界面里依次确定三件事——导谁（某个联系人或群聊，群聊记得勾上）、导哪段（时间范围）、导成什么格式（HTML / Word / CSV）。

成功标志：导出跑完，保存目录里出现对应的文件；HTML 文件双击用浏览器打开，排版和微信原版几乎一致，图片表情正常显示。出错先看哪里：记录量大时别一把梭——先导最近一年，再往前推分批来；同时把内存和磁盘留点余量，别开着重应用一起跑。

第 4 步：核对产出，补漏

做什么：翻一遍导出目录，确认每个对象都有对应文件；发现哪个群聊缺席了，回到选择步骤单独补导一次。

成功标志：目标联系人的消息条数和你印象量级对得上，格式文件都能正常打开。出错先看哪里：某个群聊结果找不到，多半是选择环节只勾了个人没勾群，回去补勾再导。

导出文件怎么用：三个格式各管一摊

跑完你拿到的是每个对象对应的导出文件，外加一份年度聊天报告聚合。三种格式定位很清晰：

按用途挑：HTML 负责看，Word 负责印，CSV 负责算。

进阶玩法一句话：CSV 丢进 Excel 拉透视表，每个联系人的消息量一目了然；会用 pandas 的还能继续聚合话题趋势、群活跃时段。更多项目说明见 readme，示例图在 doc/ 目录里。

排障速查：四个真会碰到的问题

• 现象：点连接后提示找不到微信数据原因：微信桌面版没完全退出，或当前账号未登录处理：彻底退出（含托盘图标）重新登录，再点连接

• 现象：启动直接报 ModuleNotFoundError原因：依赖装到了系统 Python，虚拟环境没激活处理：先激活虚拟环境，再重跑安装命令

• 现象：导出大记录量时卡住或中断原因：一次导全量，内存和磁盘被占满处理：按年份或联系人分批导出，错峰运行

• 现象：某个群聊的导出结果找不到原因：选对象时只勾了个人，群聊没勾处理：回到选择步骤勾上群聊，单独补导一次

高频问题速答

支持手机版微信吗？目前面向电脑版，手机端权限和加密限制多，不在重点范围。

导出会动到原始记录吗？不会。全程只读，原库原样留着，导出期间微信照常能用。

群聊能导吗？能。联系人选择步骤里勾上群，该群聊天记录整体导出。

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

记录落到自己硬盘上，往后换手机也好、重装系统也罢，随时可以再导一遍。

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