WeChatMsg 免费开源指南：3 步把微信聊天记录导出成 HTML、Word、CSV，还能生成年度聊天报告

WeChatMsg 免费开源指南：3 步把微信聊天记录导出成 HTML、Word、CSV，还能生成年度聊天报告

【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg

手机丢一次你就会发现：过去十年的聊天记录只存在微信的缓存里，不在你手里。而WeChatMsg是一款完全免费的开源工具，能把电脑版微信里的聊天记录导出为 HTML、Word、CSV 文档永久保存，还能基于记录生成年度聊天报告。全文 3 分钟读完，10 分钟跑通第一次导出。

截图和本地缓存为什么靠不住

问题不在于你不够勤快，而在方式：截图散落在相册，检索只能一张张翻；数据绑死在一台设备上，清缓存、换手机就丢；想找三年前某群里说过的话，只能靠肉眼上滑窗口十分钟。

先导出，再保管——把聊天数据变成你能永久持有、随时检索、自己分析的标准文档。

10 分钟跑通第一次微信聊天记录导出

第 1 步：一键克隆并装好依赖

确认电脑有 Python 环境，克隆项目并在虚拟环境里装依赖，避免污染全局包。

# 确认 Python 版本（需要 3.x） python --version # 克隆项目并进入目录 git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg # 创建并激活虚拟环境 python -m venv venv # Windows 激活：venv\Scripts\activate # Mac/Linux 激活：source venv/bin/activate # 安装依赖 pip install -r requirements.txt

⚠️ 最容易踩的坑：直接往全局环境 pip 装，极易和其他项目冲突；务必用虚拟环境。另外项目 README 中说明该项目已进入维护模式，若安装报错，先按 README 核对兼容环境。

第 2 步：启动程序并连接微信数据

运行主程序，图形界面出现后按提示连接微信数据，用电脑版微信扫码登录即可读取本机记录（入口脚本名如有差异，以 README 说明为准）。

# 启动主程序（会弹出图形界面） python main.py

⚠️ 最容易踩的坑：没退出电脑版微信就连，数据库文件被占用，读取必挂。先彻底退出微信（含托盘图标）再运行。

第 3 步：选定联系人与时间范围，一键导出

在界面里勾选要导出的联系人或群，指定时间范围（如"2024 全年"），选择输出格式——HTML 适合浏览、Word 适合排版存档、CSV 适合数据分析，点导出等待完成。

# 导出后快速抽查 CSV 头部，确认内容完整（文件名/路径换成你实际的） head -n 5 导出聊天记录.csv # Windows 用 PowerShell：Get-Content 导出聊天记录.csv -TotalCount 5

⚠️ 最容易踩的坑：几十万条一次性全量导出，进度卡顿、磁盘告急；按时间分段、按联系人分组导出，并存到非系统盘。

导出产物长什么样：从聊天记录到可检索档案

产物就是普通文件：HTML 按聊天窗口样式组织记录，方便翻看和搜索；Word 拿来排版打印即可；CSV 一条消息一行，带上时间、联系人、内容等字段（具体字段以实际导出为准）。

年度聊天报告则把一整年的记录整理成图表报告，另有个人版与双人版（具体报告项以实际版本为准，仓库 README 中附有 2024 年度报告样例）。

↑ 报告页可视化风格预览（2025 年度报告将在作者后续项目中实现，详见仓库 README）

如果这是你的数据——"今年和谁聊得最多""深夜活跃还是早晨活跃"，都会被图表直接回答，不用翻聊天窗口。

一个完整用例：把导师的指点攒成一本"工作手册"

小陆去年换了工作，带她的导师即将调岗。临别前，她用 WeChatMsg 把两人两年的单聊导出成 CSV，用表格按周分组：发现导师每周五晚都会发一段"本周小结"。她把这些消息按主题整理进 Word，打印装订，取名叫《导师手册》。散落在窗口里的其实是完整的工作方法论，只是没人整理过。

可复制做法：两年记录、CSV 导出、按周分组、Word 排版、打印归档

进阶玩法：用 pandas 从导出的 CSV 里挖规律

CSV 到手后，二次分析随你发挥。比如统计消息量最多的 10 天，看清沟通最密集的时间点：

import pandas as pd # 读取 WeChatMsg 导出的 CSV（文件名与路径换成你实际的） df = pd.read_csv("导出聊天记录.csv") print(df.head()) # 先看表头，确认实际列名 # 确认时间列名后（下面示例为 "time"），按日期统计 df["date"] = pd.to_datetime(df["time"]).dt.date print(df["date"].value_counts().head(10))

数据一旦结构化，就能接入任意分析工具，周度沟通节奏、各群消息占比这类"社交统计"，都是一条 groupby 的距离。

避坑指南：四个最常见的翻车场景

坑：没退出电脑版微信就连→ 数据库文件被占用，读取必挂。彻底退出微信（含托盘）再运行。

坑：想导出手机端的记录→ 工具读取的是电脑版微信的本地数据，手机端记录受系统限制无法导出。想让记录完整，就保持电脑版长期登录积累，再导出。

坑：微信版本较新，程序读不到数据→ README 明确项目已长期未更新，本地数据库格式变化后兼容性不保证。先按 README 核对支持的微信版本，能用的版本别随手升级。

坑：几十万条一键全量导出，卡在半路→ 按时间范围、按联系人分段导出，存到非系统盘，并关掉其他吃内存的大程序。

坑：期待图片、语音全部原样保留→ 媒体文件的保留效果具体以项目 README 为准；重要的图片、语音建议再用微信自带备份另行存档一份。

开头那句"记录不在你手里"，现在有了答案：它们还在，只是该搬进你自己的硬盘了。你真正拥有的不是那个 App，而是随时能带走的数据。这周末花 30 分钟，把最在意的那段记录导出成第一个存档文件。

【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg