微信聊天记录导出完整指南：WeChatMsg 用 3 条命令把微信记录留下来
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
那些聊了好几年的对话，换手机或重装系统后就再也打不开了——它们其实一直躺在 PC 版微信的本地数据库里，机器一换就跟着消失。WeChatMsg 是一款开源的微信聊天记录导出工具：直接读取这个本地数据库，把你的对话转成可浏览、可搜索的 HTML、Word、PDF 文件，还能顺手生成年度聊天报告。
✅ 微信记录导出工具的能力与边界：能做什么、不能做什么
先说它能干的：
- 按联系人（群或好友）批量导出全部历史消息，一次成一个完整文件；
- 输出格式支持 HTML、Word、CSV、PDF，图片、语音可随文本一起带出；
- 支持按起止日期圈定范围，只导某一段时间；
- PDF 可加密码，放进移动硬盘也不怕被随手翻开；
- 内置分析功能，能把记录过一遍：关键词热度、活跃时段、情感变化，汇成年度聊天报告，效果样例在 doc/ 目录里可以翻到。
再说边界，这条很重要：
- 它的原料是PC 版微信的本地数据库。如果你只用手机微信、电脑上从没登过 PC 端，那就没有数据库可读，这篇文章可以就此放下。
- 它不做云端同步，导出结果受你当前微信版本和登录状态影响，不是万能保险箱。
- 只想留一两条消息？截图比装工具更快，不必为难自己。
🧰 环境准备步骤：开工前要核对的三件事
导出开始前，把下面三样东西点一遍：
- Python 3.8 或更高版本。终端里敲
python -V看一眼版本号，低于 3.8 就去官网装一个； - 最新版微信 PC 客户端，并且处于登录状态——数据库就存在它里面，不登录等于没原料；
- 磁盘空间留够。带图片、语音的导出体积不小，空间紧的话先清一清。
三样都齐了，把代码和依赖拉下来：
git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg pip install -r requirements.txt跑完这三行，代码和依赖就都到位了。更多项目背景可以看 readme.md。
⌨️ 微信记录导出命令与参数表
第一次别加任何修饰，就跑最小的一条：python wechat_export.py --contact "家人群" --format html。执行完输出目录里会多出一个 HTML 文件，用浏览器打开，这个群的消息全在，页面里直接搜关键词。确认消息和时间线没问题，再考虑往下加料。
关键参数对照如下：
| 参数 | 作用 | 示例 |
|---|---|---|
--contact | 指定要导出的群名或好友昵称 | --contact "家人群" |
--format | 选择输出格式 | --format html/word/csv/pdf |
--start-date | 只导这个日期之后的消息 | --start-date "2026-03-01" |
--end-date | 只导这个日期之前的消息 | --end-date "2026-08-31" |
--include-media | 把图片、语音和文本一起带出 | 直接加上，不带值 |
--output | 自定义输出文件名 | --output "备份.html" |
--password | 给 PDF 加密 | --password "your_password" |
格式该怎么挑，一张表说清：
| 格式 | 最适合 | 特点 |
|---|---|---|
| HTML | 日常翻查、转给朋友 | 浏览器直接打开，页内可搜索 |
| CSV | 想翻数据、做统计 | Excel 直接打开，筛选聚合方便 |
| Word | 正式文档 | Office 里可编辑、可打印 |
| 长期存档 | 可设密码，别人打不开 |
几种格式互不冲突，同一份记录各导一版也不费劲：日常留一份 HTML，要加工数据再补 CSV，有存证需求就走 PDF。
📂 两个真实场景：群记录备份与加密存档
场景一：给"项目群"最近半年的消息留一份归档。先在 PC 微信里找到一条你记得确切时间的消息，导出后拿它核对时间线是否完整。然后限定范围，把时间参数加上：
python wechat_export.py --contact "项目群" --format csv \ --start-date "2026-03-01" --end-date "2026-08-31"半年消息变成一张表格，按天、按人筛选都顺手，交接工作时直接甩出去。
场景二：和某位好友的私聊要留作长期纪念，又不想内容被人看到。换成 PDF 并加密：
python wechat_export.py --contact "阿哲" --format pdf --password "your_password"生成的 PDF 打开前必须输密码，存哪儿都不慌。想要图、语音也在文件里，两个场景里都追加--include-media即可。
🩹 微信记录导出报错排查清单
| 遇到的状况 | 先查什么 | 还不行就 |
|---|---|---|
| 提示数据库无法解密 | PC 微信是否为最新版本、是否已登录 | 用管理员权限重新跑一遍命令 |
| 导出的文件里缺图片、语音 | 导出时有没有带--include-media | 检查媒体文件的保存路径是否被动过 |
| 文件大得打不开 | 用--start-date、--end-date把时间范围拆开，分段导 | 只导文本，先跳过媒体 |
🌙 今晚就做这件小事：导出一份你最舍不得的群
别贪多。今晚挑一个最舍不得丢的群，把前面那条 html 命令跑一次，打开文件确认消息都在——这一步五分钟就能结束。明天再决定要不要补 CSV 或年度报告。
最后一句实话：WeChatMsg 的全部处理都发生在你自己的电脑上，不经过任何第三方服务器，导出的文件完完整整归你所有。把"每季度导一次"变成习惯，丢聊天记录这件事就不用再想了。
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
