WeChatMsg 快速教程：3 条命令把微信聊天记录导出成可搜索文档
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
聊天内容难以长期检索，删除电脑端后数据随之消失。WeChatMsg 是一款免费开源的聊天记录备份工具，可把微信聊天记录导出为 Word、HTML、CSV 文档，并生成年度聊天报告。
🚀 上手速览：3 条命令跑起 WeChatMsg
① 检查环境。WeChatMsg 基于 Python 开发，要求 3.7 及以上版本，终端输入python --version可确认版本号；未安装时去官网下载，安装时勾选"Add to PATH"。
② 获取代码。拉取仓库并进入目录，看到main.py和requirements.txt即说明项目完整：
git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg③ 安装依赖。建议先创建独立虚拟环境，避免依赖版本与其他项目冲突：
python -m venv venv pip install -r requirements.txt安装前需先激活环境，Windows 用venv\Scripts\activate，Mac / Linux 用source venv/bin/activate。网络环境较慢时，把 pip 源临时换成国内镜像可明显提速。
最后彻底退出微信电脑版——右键托盘图标退出，仅关窗口不算——再运行python main.py。界面弹出后按提示登录，程序自动定位并解析本地数据库，导出界面会列出本机的全部会话与群聊。
🗂 能力 × 场景：一次导出，三种用途
三种格式各有分工：HTML 保留聊天界面观感，Word 适合打印归档，CSV 适合统计分析。
归档重要对话。需要反复回看某段对话时，把它存成可检索文档比留在客户端更可靠。在导出界面勾选目标会话，设置时间范围，选择微信导出 Word 格式并指定保存目录。产出物是带日期与上下文的 Word 文件，可打印、可归档、可按关键词检索；记录量大时按年份分批导出更稳。
量化沟通习惯。想知道自己哪个月最忙、哪个群最活跃，把数据交给表格。选择 CSV 格式导出，用 Excel 或 pandas 打开后按联系人、月份两列聚合即可。产出物是标准表格数据，透视表就能给出答案，也能直接喂给脚本做二次统计。
生成年度聊天报告。年底复盘时，数据比回忆更有说服力。选择全年记录并生成年度聊天报告，无需手工整理。产出物是含消息总量、高频联系人、活跃时段等统计的图文报告，相当于给自己的一年出一份年报。
🔍 它怎么做到：本地数据库解析
你平时聊天的内容，早已被微信电脑版写入本机数据库文件。WeChatMsg 的微信数据库解析，像给聊天记录拍一张 X 光片：射线不接触身体，只把内部结构投到一张底片上。它只读解析本机数据库，不访问服务器与云端，全程不联网；把零散数据按"谁、在何时、发了什么类型消息"整理成可读记录，再按你的配置输出 HTML、Word 或 CSV。原始数据始终留在本机，不被修改或删除。代码完全开源，MIT 协议，行为可逐行验证，设计思路见 readme.md。
🧭 踩坑与边界：4 个高频问题
该工具面向微信电脑版环境。
- 遇到启动时提示找不到数据库 → 原因是微信电脑版未彻底退出，数据库文件正被占用 → 从托盘完全退出微信后再启动。
- 遇到导出内容缺失或解析异常 → 原因是当前微信版本的数据库格式与解析逻辑不匹配 → 对照仓库文档支持的版本范围，保持电脑端微信版本不变。
- 遇到大批量导出耗时过长 → 原因是数万条消息一次性处理 → 按年份分批导出，关闭实时预览，预留磁盘空间。
- 遇到图片只是缩略图、语音变成文字 → 原因是程序只导出数据不提取媒体文件 → 用微信自带备份功能单独留存原始媒体。
你导出的不是数据堆，而是回看过去的权利。先把最重要的对话导出成 Word，再为今年生成一份年度聊天报告，然后设置每月提醒，让备份持续进行。
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
