Mac 微信聊天记录导出完整教程:WeChatMsg 5 分钟把记录变成 4 种文档格式
【免费下载链接】WeChatMsg提取微信聊天记录,将其导出成HTML、Word、CSV文档永久保存,对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
整理 Mac 磁盘时发现微信占了数百 GB,删了又怕几年的聊天历史跟着丢。WeChatMsg 是一款免费开源的 Mac 微信聊天记录导出工具,能把本机记录转成 HTML、CSV、DOCX、JSON 四种文档格式,还能生成年度聊天报告,全程在本地完成。
Mac 安装 WeChatMsg 步骤:5 步跑通微信记录导出
有一个前提先交代:Mac 版微信装好、并且至少登录使用过一次,聊天数据库才会落盘,工具才有东西可读。项目目前处于相对稳定的维护阶段,核心导出与年度报告功能都可直接使用。
第一步,把代码取下来:
git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg这两行把项目源码下载到你的电脑上,然后进入项目目录。
第二步,准备环境:
python3 -m venv venv source venv/bin/activate第一行给这个项目搭一张专属"工作台",所有依赖都放在上面、不碰系统环境;第二行走进去开工。
第三步,装依赖:
pip install -r requirements.txt照着项目里的"需求清单"逐个安装运行所需的 Python 包。
⚠️ 第一个最容易踩的坑提前说:如果这一步某个 sqlcipher 相关的包装不上、报编译失败,说明系统缺加密库。先执行brew install sqlcipher把库装上,再重新跑一遍上面的安装命令即可。
第四步,跑第一次全量导出:
python main.py --export-all命令跑完后,项目目录下的exports文件夹里每个联系人、每个群各有一个文件夹,HTML 文件用浏览器打开就能看。至于里面一堆文件该用哪个,下一节帮你挑。
微信记录导出文件怎么挑:HTML、CSV、DOCX、JSON 分别适合什么
先问用途,再看格式,名字反而没那么大用处:
- HTML——用来浏览:浏览器双击就能翻,图片和时间线都保留,适合慢慢回看历史记录
- CSV——用来进表格:Excel、Numbers 直接打开,能搜索、能统计,工作交接和项目复盘都顺手
- DOCX——用来打印归档:生成 Word 文档,打印装订、存进档案都行
- JSON——给程序二次处理:结构化数据,方便脚本或其他工具接着用
两个进阶能力,按需使用:
- 按人和按时间筛选:只导出某个人的单聊、某个群,或只拿一整年的记录,不必全量倒出来
- 年度聊天报告:运行
python main.py --generate-report --year 2025,会得到一张图表页——哪个时段你最活跃、和谁聊得最勤、全年消息量走势
↑ 报告可视化风格的样式预览,项目的缘起背景可查仓库内的 readme.md
挑好文件之前,还有几件事花一分钟确认一下。
WeChatMsg 动手前核对清单:运行导出命令先确认 4 件事
隐私这块大家最关心,直接放进清单里一起核对:
- 本机微信已经登录并使用过至少一次,数据库已落盘
- 全程不依赖联网:读库、解密、转换、生成报告都在这台 Mac 上完成
- 没有账号体系、没有服务器,你的记录不出这台设备
- 导出结果默认落在项目目录下的
exports文件夹,存哪儿、要不要备份由你决定
确认无误,就可以按自己的需求把导出做得更精细了。
微信记录导出进阶用法:定向导出、按年筛选与定时备份
只想导某一个人的记录?运行导出命令(如python main.py --export-all),在提示中选择目标联系人或群即可,单聊、群聊都支持,不必全量导出。
只想拿某一年、或者想搬进表格?跑导出命令时用时间筛选只取一整年;提示出现时选择想要的格式,比如选 CSV,导出后直接用 Excel、Numbers 打开,搜索统计都方便。
想每月自动备份一次微信记录?给导出命令加一个 crontab 定时任务就行,一两行的事,之后每月自动跑,不用惦记。
导出文件太大,好几个 GB?大头是图片和视频。导出时加上 text-only 参数只留文字;或按半年分段导出;导出后压缩存档,都能省不少空间。
万一有东西不按预期走,先别慌,对着下面的表查。
WeChatMsg 报错自救手册:看到报错信息直接找解法
| 报错信息 | 原因 | 一句话解法 |
|---|---|---|
pip install报 sqlcipher 相关包装不上、编译失败 | 系统缺 sqlcipher 加密库 | brew install sqlcipher装库后重跑pip install -r requirements.txt,并确认虚拟环境已激活 |
运行python main.py提示命令不存在或找不到模块 | 虚拟环境没激活,脚本找不到依赖 | 先执行source venv/bin/activate再重新运行 |
| 找不到微信数据库、或解密失败 | 微信没在本机实际使用过(数据库未落盘),或微信升级后存储方式变化 | 确认微信已登录并使用过;用git pull更新工具到最新版重试 |
| 导出结果太大、好几个 GB | 图片和视频占了大头 | 加 text-only 参数只导文字,或按半年分段导出,导出后压缩 |
WeChatMsg 快速行动清单:4 步把聊天记录存进自己的文件
- 执行
git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg取回项目,建好虚拟环境、激活它,再按清单装依赖(装不上 sqlcipher 就先brew install sqlcipher) - 核对清单:微信已登录使用过,然后运行
python main.py --export-all - 打开
exports文件夹,按用途取文件:浏览用 HTML,统计用 CSV,打印用 DOCX - 年底运行
python main.py --generate-report --year 2025,把报告连同导出文件一起移到外部硬盘存档
【免费下载链接】WeChatMsg提取微信聊天记录,将其导出成HTML、Word、CSV文档永久保存,对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考