WeChatMsg 完整上手指南：Mac 微信聊天记录导出 4 种格式 + 年度报告
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
WeChatMsg 是一款免费的 Mac 端微信聊天记录导出工具：它读取你电脑里的微信本地数据库，把聊天内容导出成 HTML、CSV、DOCX、JSON 四种文档，还能分析并生成年度聊天报告。这篇文章只讲三件事：怎么装、怎么用、报错怎么办。
适用场景：谁需要导出微信聊天记录
先说结论：数据在你自己的 Mac 里，工具也是纯本地跑，适合任何想给微信记录"留底"的人。
- 📦换设备前留底：你重装系统或换电脑前，想给家人的群聊、重要的单聊存一份保险，导出成 HTML 网页最直观，浏览器一开就能翻
- 📄工作留档：你是项目相关人，需要把某个群的记录整理成文档做交接、复盘或归档，CSV 和 DOCX 可以直接进表格软件或打印
- 📊年度复盘：你想看自己一年发了多少消息、和谁聊得最多，跑一份年度聊天报告，图表直接说明问题
数据去向这里说清楚：它读的是你本地磁盘上的微信数据库，全程不联网、不上传，没有账号和服务器，导出的文件默认落在项目的exports目录，存到哪、要不要再拷一份，都由你决定。
跑起来：安装步骤 + 首次运行
整个过程分三步，照着敲就行。
1. 准备：把源码拿下来
git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg你会看到：当前目录下多出一个WeChatMsg文件夹，里面的 readme.md 是项目自带的说明文档。
2. 安装：装依赖
虚拟环境相当于在项目旁边开一个专用工具箱，只装这个项目要的 Python 库，系统里其他东西一点不受影响。
python3 -m venv venv source venv/bin/activate pip install -r requirements.txt你会看到：依赖逐个安装。如果卡在 sqlcipher 相关的包上编译失败，跳到下面"常见问题"第 3 条处理。
3. 首次运行：全量导出
python main.py --export-all你会看到：运行结束后出现exports文件夹，每个联系人和群各占一个子目录，里面的 HTML 文件用浏览器直接打开，图片和时间线都在。
亮点深挖：导出格式、筛选与年度报告
说白了，它最有用的地方不是"能导出"，而是"怎么导都顺手"。
四种格式一次到位。能干什么：同一次导出会产出 HTML、CSV、DOCX、JSON 四类文件，浏览、进表格、打印、给程序处理各取所需。什么时候用：平时翻记录看 HTML，要统计就丢 CSV，要归档就存 DOCX。怎么触发：全量或按对象导出时默认生成，不用额外操作。
按对象、按时间挑着导。能干什么：不用几百个群全搬，只导某个人的单聊或某个群，也能按时间段截取，比如只要某一整年。什么时候用：记录太多年、只想留重要片段的时候。怎么触发：在导出命令后加筛选参数，具体写法以仓库内说明为准。
年度聊天报告。能干什么：把一整年的聊天情况画成图表页，哪个时段最活跃、和谁聊得最勤、全年消息量走势，一页看完。什么时候用：年底总结，或者想给朋友发一份"聊天版年度账单"。怎么触发：
python main.py --generate-report --year 2025你会看到：生成一张图表页，效果参考仓库里的 doc/年度报告.jpg。
常见问题：导出报错怎么办
1. 数据库解密失败
- 现象：程序提示找不到数据库或解密失败
- 原因：微信升级后加密方式或数据库位置可能变了
- 解法：先
git pull更新到最新版；还不行就确认 Mac 微信至少登录过一次，数据库才会落盘
2. 导出文件太大
- 现象：一个群的导出包有好几个 GB
- 原因：体积大头是图片和视频，不是文字
- 解法：按半年或按对象分段导出，导完压缩存档，别一次性全导
3. 依赖编译报错
- 现象：
pip install时 sqlcipher 相关包编译失败 - 原因：本机没有对应的加密库
- 解法：先
brew install sqlcipher再重跑pip install -r requirements.txt，装之前确认虚拟环境已激活，别装进系统 Python
最后提一句：作者已在 readme.md 里说明项目暂时停止更新，功能以当前版本为准。
WeChatMsg 把"把聊天记录搬出微信"这一件事做到了本地闭环：免费、不上传、格式齐全。今晚就能动手：clone 仓库、装依赖、跑一次全量导出，睡前就能看到exports里的文件。
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
