5 分钟把 Mac 微信记录导出成可搜索的网页：WeChatMsg 完整指南
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
你刚把旧手机里的微信换到新 Mac，想翻出三年前某个深夜和朋友的一段对话，却在聊天列表里越翻越焦虑，怕一不留神就滑过去。WeChatMsg 是一款开源工具，能把 Mac 上的微信聊天记录导出成 HTML、Word、CSV 文档，让对话既能永久保存、又能随时搜索。
数据藏在哪里：记录的真实位置和那把"锁"
先搞清楚你的记录躺在哪。Mac 版微信把聊天数据放在一个固定目录下，大致长这样：
~/Library/Containers/com.tencent.xinWeChat/Data/Library/Application Support/com.tencent.xinWeChat/真正的消息、联系人、时间戳都存在里面的 SQLite 数据库文件里。关键点是，这些库被 SQLCipher 加密过——你可以把它理解成"给数据库加了一把密码锁"：没有正确的密钥，双击打开看到的只有一堆乱码字节，读不出任何中文。所以直接拷贝这个文件夹是没用的，必须先解密，这正是 WeChatMsg 要做的事。
从加密库到可读文件：一条主线走通
整个过程分五步，每步一句话讲清原理，配最小命令。
第一步，拿到工具。把仓库克隆到本地，保证机器上有 Python 3.8 以上环境：
git clone https://gitcode.com/GitHub_Trending/we/WeChatMsg cd WeChatMsg第二步，定位数据库。用上面那段路径找到微信的.db文件，记下它的完整路径，这就是后面命令里的输入。
第三步，解密加提取。运行一条命令，工具会自动尝试解开 SQLCipher 加密，再把消息表、联系人表、时间戳读出来：
python main.py --input <微信db路径> --output ./export --format html第四步，选格式。把命令里的--format换成docx或csv，即可切换产出物，其他参数不用动。
第五步，查看结果。在./export目录里你会看到整理好的文件，HTML 直接双击用浏览器打开，能搜关键词、按时间翻。
三种格式怎么选
同一份记录，导出成哪种格式取决于你之后要干嘛：
| 格式 | 适用场景 | 优点 | 适合谁 |
|---|---|---|---|
| HTML | 浏览器直接翻阅 | 能搜索、保留对话样式、响应式排版 | 想自己回看、存档的人 |
| DOCX | 打印、纸质归档 | 保留原始排版、可用 Word 再编辑 | 需要打印或二次排版的人 |
| CSV | 数据分析、导入表格 | 结构化字段、方便筛选统计 | 要做统计、批量处理的人 |
一句话：常回看选 HTML，要留档选 DOCX，要算数选 CSV。
进阶玩法
导出来只是开始，把数据用起来才是价值所在。这里挑两个最有说服力的场景。
- 个人年度聊天报告：用 CSV 做统计，算出一年发了多少条消息、和谁聊得最多、哪个时段最活跃，最后渲染成一张可视化的年度页面。仓库里附了一张同类个人数据年度报告的效果参考，思路可以直接借用：
把一整年的数据变成可回看的页面，是这类工具最有温度的用法。
- 项目沟通归档：把某个项目相关的记录导出为 DOCX，附上关键结论和时间线，年底复盘或交接时不再靠记忆翻聊天窗口。
安全与边界
WeChatMsg 全程在你的电脑上运行，数据库的读取和导出都不经过云端，数据不会离开本机。它通过智能识别来适配多个版本的微信库结构，所以老客户端和新客户端通常都能处理。
也要坦诚说清它做不到什么：只能导出本地已落库的记录，只存在云端、还没同步到本机的消息它拿不到；已经清空且没有备份的内容无法找回；它不修改微信本体，但对加密库做逆向解析属于灰度用法，请只用来备份你自己的数据。
常见问题
Q：会把我的聊天数据上传吗？A：不会，解密和导出都在本地完成，数据不离开设备。
Q：Windows 能跑吗？A：目前以 Mac 为主，Windows 上部分功能可用，建议先看项目文档确认版本。
Q：图片和文件附件能一起导出吗？A：可以，但文件较多时会占额外空间，导出前留够磁盘。
Q：群聊和私聊会混在一起吗？A：工具能自动区分，还支持按联系人筛选导出。
下一步
进仓库克隆代码，按文档配好数据库路径，先跑一条--format html命令导出第一份记录，再按需换 DOCX 或 CSV。
【免费下载链接】WeChatMsg提取微信聊天记录，将其导出成HTML、Word、CSV文档永久保存，对聊天记录进行分析生成年度聊天报告项目地址: https://gitcode.com/GitHub_Trending/we/WeChatMsg
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
