WeChatMsg 完整教程:如何免费把微信聊天记录导出为 HTML、Word、CSV 并生成年度报告
【免费下载链接】WeChatMsg提取微信聊天记录,将其导出成HTML、Word、CSV文档永久保存,对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
WeChatMsg(留痕)是一款免费的微信聊天记录导出工具:把本机微信的聊天记录提取出来,离线转换成 HTML、Word、CSV 文档永久保存,还可以对记录做分析,生成年度聊天报告。整个过程数据只在本机流转,不经过任何云端。
报告类输出大致如上:一整年的记录交给它,会变成消息统计、活跃时段、关键词热度等可视化内容,支持缩放浏览。
适用边界:先确认 WeChatMsg 适不适合你
三类人可以放心用:想把几年的对话变成可打开、可检索文件的人;需要把记录送进 Excel 做筛选统计的人;希望把数据沉淀下来、将来喂给自己 AI 的人。两类人暂时别碰:只有手机、没有 Windows/Mac 桌面版微信的,可读取的是桌面端本地数据库;只需要把记录搬到新手机的,微信官方的迁移功能更直接——官方功能管"换设备",WeChatMsg 管"能打开、能搜索、能归档"。
要诚实交代的局限:作者在 readme.md 中写明,项目很久没有更新、未来也不会更新。新版微信一旦调整数据库结构,工具就可能读不出数据。对应的稳妥做法:先挑一个联系人验证可读性,确认没问题,再执行全量导出。
开始之前:4 项前置检查
- Python 环境:版本 3.8 及以上,避免安装依赖时报错;
- 微信客户端:确认是 Windows 或 Mac 桌面版,否则没有可读取的本地数据库;
- 磁盘空间:纯文本通常几十 MB,一旦带上图片视频会成倍增长,提前预留,避免导出到一半中断;
- 微信登录状态:保持桌面端已登录,确保本地数据库完整可读。
第一次导出微信聊天记录:最短路径
# 第一步:获取项目代码到本地 git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg然后挑一个联系人跑第一条导出命令:
# 第二步:导出单个联系人为 HTML,浏览器打开即可搜索 python wechat_export.py --contact "张三" --format html三个核心参数,记住就够了:
--contact:联系人或群名,必须与微信显示完全一致;--format:输出格式,html/word/csv三选一;--output:自定义输出文件名,省略则自动生成。
格式怎么选,看文件给谁用:
| 格式 | 选它的理由 | 体积 |
|---|---|---|
| HTML | 自己浏览、在浏览器里检索,自带搜索框 | 中等 |
| Word | 打印、正式场合发送与归档 | 较大 |
| CSV | 导入 Excel 做筛选、透视与统计,结果最干净 | 最小 |
进阶参数组合:时间范围与加密脱敏
按时间范围归档。只想留某一年、且要连图片视频一起走时:
# 导出 2024 全年记录,含媒体文件,输出 CSV python wechat_export.py --contact "工作群" \ --start-date "2024-01-01" --end-date "2024-12-31" \ --include-media --format csv --output "2024工作记录.csv"敏感数据落地前处理。记录里有手机号、身份证号这类信息时,可以让整份文件加密、敏感字段自动打码;文件体积过大时再追加--split-by-date按日期拆分;希望每周自动留一份备份的,把导出命令写进 crontab 即可。
# 加密导出:整份文件 AES-256 加密,手机号/身份证自动脱敏 python wechat_export.py --contact "工作群" --format word \ --encrypt aes256 --password "your_password" --redact-sensitive数据深挖:导出之后还能做什么
存档只是第一层。CSV 可以直接进 Excel 按月份汇总;年度报告功能会把一整年的数据变成消息统计、最活跃时段、关键词热度排名与情感变化曲线,输出为支持缩放的网页。再往远看一层:作者做这个项目的初衷,就是用你自己的数据去训练一个熟悉你说话习惯的个人 AI——导出动作本身,就是那一步的起点。
导出失败排查:卡住时按顺序查 4 项
- 读不到数据库(解密失败)——症状多为刚升级微信后报错。先核对当前微信版本是否仍在支持范围内;不在就回退版本或以管理员权限重跑,仍不行就先停手,别盲目重试;
- 导出超时或文件过大——排查是否带了
--include-media;解法是--split-by-date按日期拆分,或先只导纯文本; - 导出文件里没有图片——依次核对:命令是否显式带了
--include-media、微信本地媒体目录是否可读、磁盘空间是否足够,补齐后重跑; - 依赖报错、命令无反应——确认 Python 版本满足要求且依赖装全;更细的日志定位方法见 doc/ 目录与 readme.md。
最后一步:挑一个联系人,把备份做出来
python wechat_export.py --contact "那个名字" --format html
十分钟以内,你会得到一份可搜索、可归档的离线副本。再想一层:当聊天记录变成自己的结构化数据,能不能用它训练一个记得你生活细节的个人 AI?作者已经在这个方向上走了,而导出,正是这条路的第一步。
【免费下载链接】WeChatMsg提取微信聊天记录,将其导出成HTML、Word、CSV文档永久保存,对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考