☰
Mac 微信聊天记录导出完整教程:WeChatMsg 5 分钟把记录变成 4 种文档格式
2026/10/27 1:49:08 网站建设 项目流程

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 步把聊天记录存进自己的文件

  1. 执行git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg取回项目,建好虚拟环境、激活它,再按清单装依赖(装不上 sqlcipher 就先brew install sqlcipher)
  2. 核对清单:微信已登录使用过,然后运行python main.py --export-all
  3. 打开exports文件夹,按用途取文件:浏览用 HTML,统计用 CSV,打印用 DOCX
  4. 年底运行python main.py --generate-report --year 2025,把报告连同导出文件一起移到外部硬盘存档

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询