企业官网建设流程全解析

Mac 微信聊天记录导出实操：4 种文档格式 + 年度聊天报告，10 分钟跑通

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

WeChatMsg 是一款面向 Mac 微信用户的开源工具。本文带你完成微信聊天记录导出：直接读取本机微信的 SQLCipher 加密消息数据库，把记录转成 HTML、CSV、DOCX、JSON 四种可直接打开的格式，还能生成一页年度聊天报告。装好环境后 10 分钟内就能拿到第一批备份文件，全程离线，记录不出本机。

备份前先做三个判断

这节写给还不确定该导出成哪种格式的人——先想清楚，能省掉后面的返工。

同一个数据库，四种输出，按"给谁看"挑最省心：

也就是说，把微信记录转成 Word、Excel 这类日常格式，在这里都只是一次导出的事。

不必每次都全量搬走，缩小范围有两种手段：按对象筛选，只导出某个人的单聊或某一个群；按时间筛选，只取某一整年的记录，给特定时间段单独留档。

环境准备与首次导出

这节给第一次使用的人，按三步顺序走就行。微信的消息数据库用 SQLCipher 加密，相当于给整份记录上了锁，WeChatMsg 负责开锁并转成能读的文档。

第一步，把项目代码拉到本地：

git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg

第二步，建虚拟环境并装依赖。虚拟环境（venv）像隔出来的小隔间，项目要的库都装在里面，不碰 Mac 上其他程序依赖的包：

python3 -m venv venv source venv/bin/activate pip install -r requirements.txt

如果 pip 卡在 sqlcipher 相关包上、提示编译失败，别慌：本机缺底层加密库，先单独装一次再重跑上面最后一行即可：

brew install sqlcipher

第三步，执行第一条全量导出命令：

python main.py --export-all

跑完后，项目根目录会多出一个exports文件夹，这就是你的第一批备份文件。项目的背景、功能范围和后续计划，可延伸阅读仓库里的 readme.md。

打开与核对导出结果

这节告诉你导出的文件都在哪、怎么确认没问题。

exports/里每个联系人、每个群聊各占一个独立目录，结构清楚好找。先用浏览器打开任一联系人的 HTML 文件：图片位置、消息时间、发送顺序，应该和你记忆里微信里的样子一致。这三样齐了，这次导出就可以算通过 ✅ 同目录下的 CSV 可以丢进表格软件抽查几行，JSON 用任意文本编辑器扫一眼即可。

年度聊天报告

年末想给这一年的聊天世界盘点一下时，看这节。

python main.py --generate-report --year 2025

输出的是一张图表页：全年消息量的月度走势、发消息最集中的时间段、和你聊得最勤的对象。好比给这一年的聊天做了一页"年终述职"——平时一条条消息没什么感觉，汇总成曲线和榜单后，谁在你生活里占的位置最多，一眼就有数。报告是数据卡片加可视化主体的页面形态，风格类似这种数据页：

把这一页存下来，几年后翻出来，就是那个时期的数据快照。

数据安全：记录不出本机

备份工具里，信任比功能更优先，这节把数据流向讲清楚。

• 程序读取的是本地磁盘上微信自己的数据库，全程不联网、不上传任何内容；
• 解密、格式转换、报告生成，所有计算都在本机完成，装完即可离线运行；
• 没有账号体系，没有后端服务器，不存在"先注册再用"的环节；
• 导出结果默认放在项目目录的exports文件夹，拷到哪里、是否再备份一份，全由你决定。

进阶：定时自动备份

这节给不想每月手动敲命令的人，用 macOS 自带的 crontab，两行配置搞定。

crontab -e里加上两行：

0 3 1 * * cd /path/to/WeChatMsg && ./venv/bin/python main.py --export-all 0 3 1 * * tar -czf backups/$(date +\%Y\%m).tar.gz exports/

第一行在每月 1 号凌晨 3 点用虚拟环境里的解释器跑一次全量导出；第二行顺手把exports压成带年月命名的归档包，长期免维护地积累备份。

排查清单：最常碰到的 3 个报错

卡住的时候先看这节，每条都把最可能的原因放在前面。

Q1：程序提示找不到数据库或解密失败？最常见的原因是微信客户端升级后版本不匹配。先git pull把工具更新到最新版再试。仍不行的话，确认 Mac 微信至少登录过一次——数据库登录后才会落盘。

Q2：导出的文件夹好几个 GB，大得离谱？体积大头几乎都来自图片和视频。给导出命令加上 text-only 参数，导出包会小一个数量级。媒体也想留的话，按半年分段导出，每段单独压缩存档。

Q3：pip install 在 sqlcipher 包上报编译失败？本机缺少对应的加密库。先brew install sqlcipher，再重跑pip install -r requirements.txt。同时用source venv/bin/activate确认虚拟环境处于激活状态，别把包装进系统 Python。

结尾行动清单

准备好了就按顺序做这三件事：

1. 执行前文的 git clone 并装好依赖（遇到 sqlcipher 报错就先brew install sqlcipher）；
2. 运行python main.py --export-all，等待完成；
3. 打开exports目录，挑一个重要的群或联系人打开 HTML，确认内容完整。

做完这三步，你的聊天记录就已真正存进了微信之外的地方；有余力再补一次python main.py --generate-report --year 2025，给今年的对话留下第一张数据快照。

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