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