WeChatMsg 微信聊天记录导出：离线导出成 HTML、Word、CSV 永久保存
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
换电脑后，和闺蜜的聊天记录只迁回 3800 条，缺的那两年还躺在旧电脑一个打不开的数据库文件里。WeChatMsg 在本地读取微信 PC 端数据库，把微信聊天记录导出成 HTML、Word、CSV 文件永久保存，全程离线，数据不出本机。
导出前检查：Python 版本、微信版本、剩余磁盘空间
开始导出微信聊天记录前，先确认三件事：
- Python 3.8 及以上，装好解释器即可运行，依赖不多
- 微信 PC 客户端需在其支持版本范围内，具体状态见 readme.md；刚升级过微信的，先拿一个联系人试导出，别直接全量跑
- 磁盘：纯文本导出留几十到上百 MB 就够；要连图片一起导，先查微信媒体文件所在磁盘的剩余空间
能做什么、不能做什么，先划清边界：
| 能做 | 不能做 |
|---|---|
| 读取微信 PC 端本地数据库，导出单个联系人或群的文字记录 | 不读取手机端的聊天记录 |
| 输出 HTML、Word、CSV 三种格式，数据不出本机 | 项目长期没有大更新，刚升级的微信版本可能不在支持列表内 |
拿不准就先按"一个联系人"的最小范围试跑，报告预览图可以在 doc/ 目录里对照查看。
微信聊天记录导出的第一条命令：10 分钟拿到 HTML 文件
git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg # 导出单个联系人的聊天记录为 HTML，浏览器可直接打开 python wechat_export.py --contact "重要联系人" --format html参数说明：
--contact：填微信里显示的原名，包括空格和括号，比如"张三（产品）"。名字填错是最常见的空结果原因--format：在 html、word、csv 里选一个；这里选 html，导出的文件双击就能在浏览器里翻--output：指定输出文件名，可省略，不填时自动生成
跑完到输出目录打开生成的 HTML 文件，能看到从第一条到最新的完整时间线。第一次只导一个你最有把握的联系人，确认记录条数符合预期，再扩大范围。
按用途选格式：HTML、Word、CSV 各自适合什么
| 格式 | 最适合的场景 | 特点 |
|---|---|---|
| HTML | 自己翻看、发给别人看 | 浏览器直接打开，文件中等 |
| Word | 打印、归档成正式文档 | 兼容 Office，文件较大 |
| CSV | 进 Excel 做筛选、统计 | 结构化行，文件最小 |
一句话结论：日常存档用 HTML，要打印选 Word，要处理数据选 CSV。
两个典型场景，各一条命令。
个人存档，想把某一群几年的记录打印出来，选 Word：
python wechat_export.py --contact "家人群" --format word --output "家庭群记录.docx"进 Excel 做筛选和统计，选 CSV：
python wechat_export.py --contact "工作群" --format csv --output "2024工作群记录.csv"如果只存档不打印，把--format换成 html 即可，其余参数不变。
什么时候才需要日期范围和媒体开关
只想抽某一段时间（比如一整年）的记录，或光有文字说不清楚、要连图片一起导出来，才用这两个开关：
python wechat_export.py --contact "工作群" \ --start-date "2024-01-01" --end-date "2024-12-31" \ --format csv --include-media --output "2024工作记录.csv"--start-date/--end-date：限定导出区间，格式 YYYY-MM-DD；不填就是全量导出--include-media：把图片等媒体文件一并导出；开启前先确认磁盘剩余空间够用
单文件太大时，再补--split-by-date按日期拆分、--compress压缩输出，不要一上来就全加。
导出失败排查表：从版本到参数三步定位
| 症状 | 先查什么 | 再查什么 |
|---|---|---|
| 导出没有记录、数据库无法解密 | 微信 PC 端版本是否在支持列表内（刚升级先查这条） | 以管理员权限运行，检查系统权限 |
| 导出文件过大 | 加--split-by-date按日期拆分 | 用--compress压缩，或只导出文本 |
| 图片没进导出结果 | 是否加了--include-media | 微信媒体路径是否可读、磁盘剩余空间是否够 |
按"微信版本 → 权限 → 参数"的顺序排除，多数问题停在前两步；参数类问题基本都能靠补开关解决。
现在选一个联系人跑一遍
挑你最在意的那位联系人，把第一条命令里的--contact换成 TA 的原名，几分钟内就能在浏览器里打开结果文件。
项目长期没有大更新，现状说明见 readme.md；后续方向是把年度聊天报告做出来，再把聊天记录变成能训练个人 AI 的数据。
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
