WeChatMsg 微信聊天记录导出工具：一条命令，把记录备份成 4 种格式文件
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
换手机、重装系统之前，最怕微信聊天记录跟着丢。WeChatMsg 免费开源，一条命令即可把记录备份成 HTML / Word / CSV / PDF 文件，还能生成年度聊天报告，全程本地处理，数据不离开你的电脑。
微信聊天记录导出备份的 3 个典型场景
💡 不用等"出事了"才想到备份，这三种情况最常见：
- 旧手机报废、换新设备：微信自带迁移依赖旧机还能开机，一旦旧机损坏，几年的对话基本就没了，提前导出文件是唯一的保险。
- 重装系统：Windows 重装或硬盘重新分区后，PC 版微信的本地数据库会被清掉，聊天记录随之消失。
- 长期留档：项目交接群、家长群、涉及合同和报价的工作群，这些记录值得存成文件，几年后照样能搜到原文。
WeChatMsg 快速上手：从环境准备到导出第一个文件
把下面四件事备齐，5 分钟内能出第一个文件：
- 安装Python 3.8 及以上版本；
- 保持PC 版微信处于登录状态——聊天数据库存在 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 文件，用浏览器打开就能翻页、搜索，每条消息的内容、发言人、时间点都在。
原理一句话带过：微信把记录加密后存在本机数据库里，WeChatMsg 先定位并解密这份数据库，再渲染成你选的文件，读取、解密、输出全部在你的电脑上完成，不走任何云服务。
命令跑通后，常用参数就这几个：
| 参数 | 作用 |
|---|---|
--start-date "2024-01-01"/--end-date "2024-12-31" | 限定导出的时间段 |
--include-media | 图片、语音等媒体一并导出 |
--output "文件名.html" | 自定义导出文件名 |
--format | 切换输出为word、csv或pdf |
聊天记录导出格式怎么选：HTML / Word / CSV / PDF 对比
| 格式 | 适合场景 | 技术特点 | 体积 |
|---|---|---|---|
| HTML | 日常浏览、在线分享 | Jinja2 模板渲染，浏览器里直接搜索 | 中等 |
| Word | 正式文档、打印输出 | python-docx 生成，可用 Office 打开编辑 | 较大 |
| CSV | 数据统计、Excel 二次加工 | Pandas 写出结构化表格，筛选汇总方便 | 最小 |
| 长期存档、证据留存 | ReportLab 渲染，可加密加密码 | 中等 |
一句自创口诀：随手翻看选 HTML，进 Excel 就挑 CSV，存证归档交给 PDF，正式交付才上 Word。拿不准的话四种各导一份，互不冲突。
微信数据备份怎么做才安全：加密、脱敏与密码保护
🔒 默认状态下，定位数据库、解密、渲染导出全在你本机完成，工具不连接任何外部服务。在此之上还有三层可选增强：
| 防护 | 作用 | 开启方式 |
|---|---|---|
| 本地处理 | 所有操作只发生在本机 | 默认行为，无需设置 |
| 文件加密 | 对生成的文件做 AES-256 加密 | 加--encrypt aes256 |
| 敏感信息脱敏 | 自动打码手机号、身份证号等 | 加--redact-sensitive |
| 访问密码 | 打开导出文件前先输密码 | 加--password "你的密码" |
例如有个家长群里常出现孩子的行程和住址，或者工作群里存着客户手机号，导出时把这几个参数叠上去，文件本身就是一层"带锁的保险箱"，拷到移动硬盘里也放心。
从聊天记录分析到年度聊天报告：情绪曲线与定时备份
📊 导出只是起点，WeChatMsg 还能在本地数据上再挖一层价值：
- 情感分析：按消息顺序读完整段对话，画出情绪走向，波动大的片段会被单独标出，词表还能换成自定义情感词，更贴中文表达；
- 微信年度聊天报告：把一整年的记录汇总成全年的消息总览、活跃时间段、高频词排行、情绪起伏曲线和社交关系图谱。数据面板长什么样，可以看 doc/ 目录里的样例：
- 定时自动化：用 cron 之类的计划任务把导出命令挂成每周执行，备份文件自动落到指定目录；
- 进一步扩展：基于插件机制写自定义分析（如话题聚类、关键决策点识别），项目还提供 RESTful API，其他本地工具可以直接调用导出能力。
导出微信记录报错怎么办：4 种现象快速排查
- 提示解密失败、读不到数据库→ 先确认 PC 版微信是受支持的版本且正在登录；报权限问题时，改用管理员身份重新执行导出命令。
- 生成的文件好几个 G，打开卡顿、发不出去→ 用
--split-by-date把记录切成多段、--compress压一压体积，只要文字的话把媒体排除掉。 - 聊天记录在，图片和语音却是空的→ 检查是否挪过媒体存放位置、磁盘是否写满，导出命令里有没有带上
--include-media。 - 只导出一小段记录→ 把
--contact的群名或昵称逐字核对一遍，再看起止日期有没有卡错区间。
今天就敲下第一条导出命令
别把这件事拖到下次换机才想起。现在就去挑一个你最舍不得删的群，把那条 HTML 导出命令敲进去。等浏览器打开文件、几千条消息都摆在眼前时你会发现：备份这件事，从这一条命令开始。
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
