微信聊天记录导出完整指南在 Mac 上备份 4 种文档格式并生成年度聊天报告【免费下载链接】WeChatMsg提取微信聊天记录将其导出成HTML、Word、CSV文档永久保存对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsgWeChatMsg 是一款面向 Mac 微信用户的免费开源工具用于微信聊天记录导出它直接读取本机微信安装目录里的加密消息数据库数据库采用 SQLCipher 整体加密相当于给整份记录上了锁把聊天内容转成 HTML、CSV、DOCX、JSON 四种可直接打开的文档还能统计并生成年度聊天报告。整篇教程按先跑通、再选格式、后做报告的顺序展开装好环境后 10 分钟内就能拿到第一批备份文件。安装步骤装好环境并跑通第一条导出命令第一步把项目代码拉到本地git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg第二步准备运行环境。这里要建一个虚拟环境venv它相当于在系统旁边隔出来的一个小隔间这个项目所需的 Python 库全部装在里面不会污染 Mac 上其他程序依赖的包python3 -m venv venv source venv/bin/activate pip install -r requirements.txt如果pip install卡在 sqlcipher 相关包上提示编译失败先单独装一次底层的加密库再重跑上面最后一行即可brew install sqlcipher第三步执行全量导出python main.py --export-all跑完之后打开项目根目录下的exports文件夹每个联系人和群聊各占一个目录HTML 文件用浏览器打开就能看到带图片和时间线的完整对话。关于项目的背景、功能范围和后续计划可以看仓库里的 readme.md。四种导出格式怎么选HTML、CSV、DOCX、JSON 各适合谁同一个数据库WeChatMsg 能按用途输出四种格式按给谁看来挑最不纠结格式适合谁典型用途HTML经常翻看、浏览记录的人浏览器直接打开图片、时间线完整保留最接近微信原始观感CSV需要检索、统计的人工作交接、项目复盘时丢进 Excel 或 Numbers 做筛选和透视DOCX需要打印、归档的人打印成纸质档案或存进单位的文档归档系统JSON需要程序二次处理的人交给脚本或 AI 工具做进一步分析、转存导出时不必每次都全量搬走还支持两个常用的缩小范围的手段按对象筛选只导出某个人的单聊或只导出某一个群避免把几百个会话一次全部拉下来按时间筛选比如只取某一整年的记录给特定时间段单独留档。年度聊天报告一条命令生成一整年的聊天数据图表年末想给这一年的聊天世界做个盘点时跑这条命令python main.py --generate-report --year 2025输出的是一张图表页全年消息量的月度走势、发消息最集中的时间段、和你聊得最勤的对象一页看清。它有点像给聊天记录做了一次年度体检——平时一条条消息感知不到汇总成曲线和榜单之后谁在你生活里占的位置最多一眼就有数。把这一页存下来将来翻出来就是很有纪念意义的个人数据档案。隐私与数据安全聊天记录始终留在你的 Mac 上对备份工具来说信任问题往往比功能更优先这里把 WeChatMsg 的数据流向讲清楚程序读取的是你 Mac 本地磁盘上微信自己的数据库全程不联网、不上传任何内容解密、格式转换、报告生成所有计算都在本机完成装完即可离线运行它没有账号体系也没有任何后端服务器不存在先注册再用的环节导出结果默认存放在项目目录的exports文件夹里拷到哪里、是否再备份一份完全由你决定。常见问题Mac 微信导出时最常碰到的 3 个报错Q1程序提示找不到数据库或解密失败先git pull把工具更新到最新版本——微信客户端升级后数据库的加密方式或文件位置可能已经变化新版通常已适配。更新后仍不行的话确认 Mac 微信至少登录过一次数据库只有在登录过之后才会落盘从未登录的话本地根本没有可读取的数据。Q2导出的文件夹大得离谱好几个 GB体积大头几乎都来自图片和视频。只要文字的话给导出命令加上文本-only 参数即可导出包会小一个数量级如果连媒体也想留建议按半年分段导出每段单独压缩存档既好管理也方便日后核对。Q3pip install时报 sqlcipher 编译失败这说明本机缺少对应的加密库。按顺序做两件事先brew install sqlcipher装好底层库再重跑pip install -r requirements.txt同时用source venv/bin/activate确认虚拟环境处于激活状态避免把包装进系统 Python。定时备份用 crontab 让记录每月自动导出一次不想每月手动敲命令的话可以借助 macOS 自带的 crontab 加一条计划任务例如每月 1 号凌晨 3 点自动执行一次全量导出核心就是下面两行配置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/第一行调用虚拟环境里的解释器直接跑导出第二行顺手把exports压成带年月命名的归档包一行配置就能长期免维护地积累备份。开始你的第一次微信记录备份现在就可以动手按顺序做三件事执行前文的git clone装好依赖遇到 sqlcipher 报错就先brew install sqlcipher运行python main.py --export-all等待完成打开exports目录挑一个重要的群或联系人打开 HTML 确认内容完整。做完这三步你的聊天记录就已真正存进了微信之外的地方有余力再补一次--generate-report给今年的对话留下第一张数据快照。【免费下载链接】WeChatMsg提取微信聊天记录将其导出成HTML、Word、CSV文档永久保存对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考