微信聊天记录导出完整教程：3 步免费转成 HTML / Word / CSV / PDF，顺手生成年度聊天报告
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
想把和某个人、某个群三年的微信对话留下来，却不想一张张截图？开源工具 WeChatMsg 支持微信聊天记录导出：在你自己的电脑上，把对话一次转成 HTML、Word、CSV、PDF 四种文件，还能把全年记录汇总成一份可视化年度聊天报告。全程本地运行，记录不经过任何云端。
这篇按「先定目标 → 跑起来 → 选格式 → 补隐私 → 上进阶 → 排错」的顺序带你走完一遍，每一步只给该敲的命令、该做的选择。
① 先把目标定下来：这批微信对话要拿来干嘛
选格式别一上来就纠结"哪个最好"。先问一句：这批记录，你接下来要干嘛？用途定了，格式基本就定了。
- 想给家里人翻着看、随手搜搜：网页版 HTML 最省事，浏览器打开就能翻页、检索，还能直接转发。
- 想打印成一册，或交给别人继续改：Word 合适，Office 直接打开就能编辑。
- 想拉进 Excel 做筛选、汇总、算数：CSV 最轻，一张结构化表格，拖进去就能算。
- 想长期存档、将来可能留证：PDF 最稳，还支持加密和密码。
记住一个顺序：用途定下来，格式和参数自然就清楚了。
② 装好环境，三条命令出第一份文件
先自查三件事，全满足再往下走：
- Python 已装，版本 3.8 及以上
- 微信 PC 客户端已安装、已登录
- 磁盘还有空间（导出文件和媒体都要占地方）
接着三条命令把工具装到本地：
git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg pip install -r requirements.txt第一次导出，只给一个联系人 + 一个格式就行：
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切格式 |
⏱️ 原理可以跳过去：微信 PC 把记录加密存在本地数据库里，WeChatMsg 找到它、解密、还原成文字/时间/媒体，再渲染成你选的文件，全程不出电脑，分析只是可选项。
③ 四种导出格式摆到一起，照着用途选
| 文件类型 | 背后工具 | 占用空间 | 拿它来干嘛 |
|---|---|---|---|
| HTML | Jinja2 | 中等 | 浏览器里翻看、搜索、转发 |
| Word | python-docx | 偏大 | 打印成册、交给别人继续编辑 |
| CSV | Pandas | 最小 | 拖进 Excel 做筛选、汇总、计算 |
| ReportLab | 中等 | 长期存档、需要留证 |
拿不定就把四种都跑一遍，文件并存、互不覆盖，回头再删也来得及。
④ 隐私兜底：本地运行打底，加密、脱敏、密码三道防线
先给底气：所有导出都在本机完成，记录不经过云端。若内容涉及合同、工资、身份信息，可以逐层加防护，三道防线可叠加：
- 文件加密：加
--encrypt aes256，导出文件做 AES-256 加密。 - 敏感信息脱敏：加
--redact-sensitive，手机号、身份证等自动替换。 - 密码保护：加
--password "你的密码"，打开文件前必须先输密码。
组合起来，比如导出一个涉及个人信息的群：
python wechat_export.py --contact "工作群" --format pdf --encrypt aes256 --password "你的密码" --redact-sensitive⑤ 进阶玩法：年度报告、定时备份、对外 API
最花时间也最值的是年度聊天报告：它把一整年的记录汇总成一张可视化面板，全年统计概览、活跃时段分布、关键词热度排名、情感变化曲线、社交网络图谱都在上面。
情感分析顺着消息先后顺序把整段对话读完，标出情绪起伏最大的位置；情感词表还能换成自定义词，更贴中文的表达习惯。
- 定时备份：把导出命令挂到 cron 之类的定时任务里，每周自动跑一遍，结果落到备份目录。
- 插件 + API：基于插件机制能写话题聚类这类自定义分析；项目还提供 RESTful API，别的本地工具可直接调用导出能力。
更多数据面板参考，可看 doc/ 目录。
⑥ 出问题，先对照这份清单
- 解密失败、读不出来：多为微信版本不被支持，或客户端掉线。先确认版本兼容、重新登录微信 PC，再用管理员权限重跑命令。
- 导出的文件太大：加
--split-by-date按天切开，再开--compress压缩；只关心文字就把媒体关掉（不带--include-media）。 - 图片、语音丢了：检查媒体存放路径是否被改过、磁盘是否还够、导出时有没有带上
--include-media。 - 记录比预期少：核对联系人/群名是不是写对了，日期区间是不是卡得太窄。
把回忆从 App 里搬出来，主动权才回到你手里。挑一个你最想留存的群或那个人，今晚就跑一遍——文件落盘的那一刻，这段对话才算真正被留下来。
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
