把微信聊天记录导出成 HTML、Word、CSV：WeChatMsg 一次跑通实操

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

微信聊天记录是最难留存的数据：转发会打乱时间和图片，截图又没法规模化。但有个容易被忽略的事实——微信桌面版把你的聊天记录存放在电脑本地的数据库里，可以整体取出来。开源项目 WeChatMsg 做的就是这件事：直接读取这份数据库，把聊天记录导出成 HTML、Word、CSV 永久保存，还能把一整年的消息聚合成可视化的年度聊天报告。全程离线，只读，不碰任何原始记录。

先排除两种情况：不是每台电脑都适合导出

第一种情况：你只在手机用微信，电脑上没有装微信。这个工具的数据源就是微信桌面版的本地数据库，手机端受权限和加密限制，没有可读取的数据源。所以先确认：你装了微信桌面版，且想导出的记录已经在这台电脑上。

第二种情况：环境不达标。WeChatMsg 是 Python 项目，需要 Python 3.7 及以上，终端里执行：

python --version

打出版本号且不低于 3.7 就算通过；版本低了去官网装新版，安装时勾上 Add to PATH。

还有一层没写在表面的：只有同步到本地数据库的记录才读得到，从未同步到这台电脑的更早历史不在范围内，这不是工具的缺陷。📌

克隆仓库，用隔离环境装依赖

依赖不要直接装进系统 Python。用虚拟环境隔离开，不同项目的包互不冲突，终端里依次输入：

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

接着激活虚拟环境，两套系统命令不同：Mac / Linux 用source venv/bin/activate，Windows 用venv\Scripts\activate。激活时报"找不到文件"，多半是两套命令串了。激活后再装依赖：

pip install -r requirements.txt

跑完没有红色报错，用pip list能查到刚装的主包即可。下载慢就换国内镜像重装。如果之后启动直接报 ModuleNotFoundError，多半是虚拟环境没激活，激活一下再运行。

项目中文名"留痕"，作者的心意可以概括成"我的数据我做主"——有意义的不是微信本身，而是藏在对话框背后的那些故事。完整背景见仓库里的 readme.md。

最容易翻车的环节：先关微信，再连数据

运行程序前，把微信桌面版彻底退出——不是关窗口，连系统托盘里的小图标也要清掉。数据库文件被微信进程占着，读取会冲突。退出后重新登录微信，让账号数据就位，再运行：

python main.py

窗口打开后点"连接微信数据"，程序会自己定位本地数据库，不用手动指路径。怎么判断连成功了，看界面就行：原本是空白的联系人列表，填满了人和群。提示找不到数据的话，九成是微信没退干净或当前账号没登录——退出、重登、再点一次连接。🔄

顺带一提：这个项目已很久没有更新，支持的微信桌面版本以发布时的为准。如果你升级过新版微信后连接失败，先从这个方向排查。

选好导出格式，文件会落在你预期的地方

在界面里选导出对象（某个联系人或群聊）、设置时间范围和文件格式，确认后开始，解析和落盘都由程序完成，你只需等。三种格式按用途分工：

一句话：HTML 负责看，Word 负责印，CSV 负责算。注意群聊和个人是分开勾选的，只勾了个人，那个群的记录就不会被导出。

除了导出，项目还做聚合：一整年的聊天数据会变成年度聊天报告，聊天频率、活跃时段、高频内容全部可视化。年度报告的效果样式可以在 doc/ 目录里先睹为快：

提问之前：四个大家都会问的问题

有收费环节吗？没有。WeChatMsg 免费开源（MIT 许可），从安装到导出全免费。

导出的文件还依赖微信吗？不依赖。HTML、Word、CSV 都是独立的本地文件，可以随意移动、分享、打印，之后卸载微信也不受影响。

聊天记录删过了，还能靠导出找回吗？不能。工具只读本地数据库里存在的内容，删除即意味着本地已无这份数据，事后再想补也补不回来。在乎的记录，趁还在就导出来。

记录量大、导出耗时怎么办？时间范围在选择步骤里可以设，按年份分批导；同时给内存和磁盘留点余量，别同时跑重应用。

文件落到硬盘里，打开 HTML 回看一遍，再把 CSV 丢进 Excel 数一数这一年谁和你聊得最多。项目作者的愿望更进一步：把这些本地记录交给 AI，让它用自己的语气记住你。数据本来就是你的，现在它真正在你手里。💾

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