一条命令导出微信聊天记录：WeChatMsg 从导出到年度报告
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
WeChatMsg 是一个开源项目，直接读取电脑上的微信本地数据库，把微信聊天记录导出成 HTML、Word、CSV 文件，还能生成年度聊天报告。如果你不想因为换设备或重装系统而丢掉这些记录，可以照着下面的流程操作一遍。
先看清楚 WeChatMsg 能做什么、不能做什么
说白了，它就是一个"读取本地库 + 转换格式"的工具，不联网、不上传，能力边界比较清楚：
- 能导出文字消息，转成 HTML、Word、CSV 三种格式
- 全程在本地运行，聊天记录不经过任何服务器
- 支持按联系人、按时间范围筛选导出
- 能统计全年聊天数据，生成年度报告
- 不能跨设备拉取云端记录，只处理本机登录过的那份数据
- 图片和视频不会自动打包，需要配合本地媒体目录
| 能做 | 不能做 |
|---|---|
| 文字消息导出成 HTML/Word/CSV | 拉取其他设备或云端的聊天记录 |
| 本地处理，数据不上传 | 自动打包图片、视频等媒体文件 |
| 按联系人、按时间范围筛选 | 读取未在本机登录过的账号数据 |
适合两类人：想给自己留一份可浏览记录的人，和想拿聊天记录做表格分析的人。
如何在电脑上第一次导出微信聊天记录
先跑通一条最小命令，确认能读到本地数据库，再谈其他参数。
git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg python wechat_export.py --contact "重要联系人" --format html先用最小命令验证"库能读出来"，比一上来就堆参数更容易定位问题；导出成功后会在输出目录生成一个可直接双击打开的 HTML 文件。
我想导出微信记录，该选哪种格式？
不同格式各有用处，选错格式后面会返工：
| 格式 | 适合场景 | 特点 |
|---|---|---|
| HTML | 自己浏览、发给人看 | 双击就能打开，带时间线 |
| Word | 打印、存档、办公 | 可编辑排版，文件较大 |
| CSV | 进 Excel 做表格 | 结构最规整，体积最小 |
| 长期存档、留证 | 版式固定，不易被改 |
要只导某一年的记录，加上时间范围即可：
# 只导 2024 年，输出 CSV 方便用 Excel 打开 python wechat_export.py \ --contact "工作群" \ --start-date 2024-01-01 \ --end-date 2024-12-31 \ --format csv \ --output 2024工作群.csv指定--start-date和--end-date能明显减小文件体积，也避免一次读入全部记录导致内存吃紧。个人存档建议 HTML 加 CSV 各导一份，浏览和加工两不误。
记录特别多时不用自己拆，工具会分块读取、只处理增量，避免一次性占满内存，这部分不需要额外配置。
📊 我想分析聊天记录，能挖出哪些信息？
导出之后，WeChatMsg 还能对文字消息做统计，不用自己再写脚本：
- 全年消息量、最活跃时段、关键词热度排名
- 对话里的情绪走向，标出明显的情绪波动点
- 按联系人、按群组生成年度报告，配图表可视化
生成年度报告这一步不需要额外配置，统计逻辑和导出用的是同一份本地数据，多跑一次分析命令就能出图。
🔒 我想保护隐私，导出前要设置什么？
如果担心导出的文件被别人拿到，可以在导出时直接做这几件事：
| 设置 | 作用 |
|---|---|
--encrypt aes256 | 用 AES-256 加密导出文件 |
--password "..." | 打开文件需要输入密码 |
--redact-sensitive | 自动替换手机号、身份证号等敏感信息 |
python wechat_export.py \ --contact "家人" \ --format pdf \ --encrypt aes256 \ --password "your_password" \ --redact-sensitive \ --output 家人记录.pdf加密和脱敏都发生在本地，文件生成后才受保护，所以生成后的文件别再随手转发。
🛠️ 导出微信记录踩坑速查
遇到报错，先按下面的思路排查：
- 数据库无法解密→ 多半是微信版本不匹配或权限不够，用管理员权限重开终端再试一次。
- 导出文件太大→ 先加
--start-date/--end-date切时间，再考虑只导文本、不打包媒体。 - 图片、视频丢了→ 确认微信本地媒体目录还在、磁盘空间够，必要时用
--include-media明确包含。 - 群记录不全→ 检查该群是否在本机登录过，云端未同步的消息本机本来就取不到。
想长期保留的话，挂一条定时任务每周固定时间自动导出，例如0 2 * * 0配一条导出命令，输出文件名里带上日期就不会互相覆盖。
✅ 行动清单
- 确认电脑上登录的是最新版微信 PC 客户端
- 用最小命令先导一个联系人，验证数据库能读取
- 给自己常用格式各导一份（HTML 浏览 + CSV 存档）
- 对敏感记录加上加密和脱敏再导出
- 设一条定时任务，按周自动备份重要会话
更多用法和项目背景见 项目说明。
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
