微信聊天记录导出完全指南：4 种格式加年度报告，数据不出本机
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
微信聊天记录只存在于你的手机和电脑里，换设备、重装系统或数据库损坏，过往对话可能就找不回来了。WeChatMsg是一款免费开源的微信聊天记录导出工具：它读取微信 PC 端本地数据库，能导出为 HTML、Word、CSV、PDF 四种格式，还能生成年度聊天报告。照这篇走一遍，你自己就能跑通第一次导出。
🧭 一分钟看懂能力总览
先摸清它能帮你干几件事，心里有数再动手：
- 读取微信 PC 本地数据库，解密读取后导出HTML、Word、CSV、PDF四种格式的记录文件。
- 全部解密和导出都在你的电脑上完成，记录不经过任何云端。
- 内置情感分析，可以按对话顺序走一遍，标出情绪走向和明显波动点。
- 生成年度聊天报告，包含全年统计、活跃时段分布、关键词热度排名和社交网络图谱。
✅ 动手前核对清单
四项都过一遍再开始，缺一项后面怎么跑都会卡住：
- Python：版本 3.8 及以上，终端里查一下版本号。
- 微信 PC 客户端：装最新版并正常登录。本地数据库在 PC 端，主要用手机微信的话这条路走不通。
- 磁盘空间：导出文件加图片、语音媒体，会占不少容量，目标盘留几个 GB 余量。
- 依赖安装：把代码克隆到本地、装好依赖。这一步常被称作WeChatMsg 安装：
git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg pip install -r requirements.txt🚀 第一次导出三步走
- 装依赖：确认上面 clone 和
pip install -r requirements.txt都执行成功，没有报错。 - 确认环境：微信 PC 已登录，导出期间别退出账号，窗口保持打开。
- 执行最小命令：只需要联系人名称和格式两个信息，别的都不用：
python wechat_export.py --contact "家人群" --format html跑完后去输出目录找到生成的HTML文件，双击用浏览器打开：发言人、时间、消息体都在，页面里可以直接搜索、翻页。文件能打开，说明路径已打通，后面所有参数都挂在这条命令上。
📋 常用参数配方
参数都是往第一条命令上追加。对号入座，直接粘贴：
- 只导某段时间：加
--start-date "2024-01-01" --end-date "2024-12-31"，适合只备份去年的记录。 - 连图片语音一起导出：加
--include-media，不带的话只导文字。 - 指定输出文件名：加
--output "存档.html"，免得默认命名不好找。 - 切换格式：把
--format的值改成word、csv或pdf，其余参数不变。
比如要把去年的群聊连媒体一起导出为Word：
python wechat_export.py --contact "工作群" --format word \ --start-date "2024-01-01" --end-date "2024-12-31" --include-media📄 导出格式对照表
| 格式 | 适用场景 | 技术实现 | 体积 |
|---|---|---|---|
| HTML | 日常浏览、在线分享 | Jinja2 模板渲染，浏览器内可搜索 | 中等 |
| Word | 正式文档、打印输出 | python-docx 生成，Office 可直接编辑 | 较大 |
| CSV | 数据分析、Excel 二次加工 | Pandas 写出结构化表格 | 最小 |
| 长期存档、证据留存 | ReportLab 渲染，支持加密加密码 | 中等 |
选型建议：自用和分享给别人看，先导出 HTML、PDF 各一份；要用 Excel 做统计，就补一份 CSV；需要"立起来"归档或备证的走 PDF。四种不冲突，各导一份也不费事。
📊 生成聊天记录分析报告
导出只是一半价值，另一半在分析。
情感分析模块按对话顺序走完一整段聊天，输出整体情感走向，标出明显的情绪波动点，还支持自定义情感词表，判断更贴近中文表达习惯。年度报告更直观：它汇总全年记录，产出一份聊天记录分析报告，包含全年统计概览、活跃时段分布、关键词热度排名、情感变化趋势和社交网络图谱，一年聊了多勤快、跟谁聊得多，一眼看清。
完整效果样例在 doc/ 目录里，先看年度报告可视化长什么样：
🔒 数据不出本机
所有读取、解密、导出都发生在你的电脑上，工具不连接任何外部服务器。默认本地处理之外，还有几层可选防护：
| 防护层级 | 防护内容 | 启用方式 |
|---|---|---|
| 本地处理 | 全部操作在用户设备完成 | 默认启用 |
| 文件加密 | AES-256 加密导出文件 | 加--encrypt aes256 |
| 敏感信息脱敏 | 自动替换手机号、身份证等 | 加--redact-sensitive |
| 访问控制 | 打开导出文件需要密码 | 加--password "你的密码" |
涉及合同内容、个人信息的群，可以这样组合：
python wechat_export.py --contact "工作群" --format pdf \ --encrypt aes256 --password "your_password" \ --redact-sensitive导出后文件无法直接打开，要输密码才能解密。哪怕它被拷到移动硬盘或备份盘里，也不用担心内容外泄。
🛠️ 跑不通时自查
- 本地数据库无法解密或读取失败：确认微信 PC 客户端是支持的版本且已登录；检查系统权限是否足够；必要时用管理员权限重新运行导出命令。
- 导出文件过大，打开或发送困难：加
--split-by-date按日期切分，再开--compress压缩；只关心文字就跳过媒体，只导文本。 - 图片、语音导出来缺失：确认微信媒体存储路径没被改过、磁盘空间充足，导出时明确加上
--include-media。 - 跑完没找到文件：核对
--contact的群名或昵称与微信里是否一字不差，空格和全半角字符都算。 - 导出中途卡住或中断：把时间范围拆小，分批执行，别一次拉全年。
⏰ 熟练之后
- 定时任务：用 cron 把导出命令挂成每周固定执行，结果自动落到备份目录，不再靠自觉。
- 自定义分析：有开发能力的话，可以基于插件机制写话题聚类、决策点识别这类自定义分析。
- API 集成：项目提供了 RESTful API，其他本地工具可直接调用导出能力，不用每次手敲命令。
别等换设备那天才开始折腾。今天就挑一个你舍不得丢的群或联系人，把"第一次导出三步走"里那条命令跑一遍。打开页面看到记录都还在，剩下的就是格式和节奏的事了。
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
