GetQzonehistory：QQ空间早期说说翻不到，一次扫码十分钟搞定历史说说备份-平芜编程栈

GetQzonehistory：QQ空间早期说说翻不到，一次扫码十分钟搞定历史说说备份

【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory

GetQzonehistory 是开源的 QQ 空间说说导出工具：扫码登录一次，批量抓取账号下所有可见的历史说说，本地生成 Excel、图片与网页，解决网页版拿不到早期记录的问题。

它到底帮你做了什么

扫码登录，全程不用输入账号密码
分页抓取历史说说，覆盖几年前、网页版已经翻不到的旧记录
把说说里的图片自动下载到本地磁盘
按说说、转发、留言、好友等分类整理成多张 Excel 表
生成网页版时间线，浏览器打开就能逐年翻看

跑通它：从克隆到出结果

克隆代码并搭好虚拟环境

需要 Python 3.7 及以上版本。把仓库克隆到本地并进入目录，创建一个叫 myenv 的虚拟环境，避免依赖污染系统环境。Windows 用第一条激活命令，Linux/macOS 用第二条。

git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory

python -m venv myenv myenv\Scripts\activate # Windows source myenv/bin/activate # Linux / macOS

命令跑完没有报错、能进入该目录，这一关就算过了。

一条命令装好依赖

装依赖的命令就一条。注意 pyzbar 依赖系统的 zbar 共享库，pip 不会替你装：Linux 建议先用系统包管理器装 zbar（Debian 系装 libzbar0），macOS 用 brew 装 zbar，否则启动会直接报错退出。

pip install -r requirements.txt

看到各依赖显示安装成功或已满足，就算装好了。

启动程序，打印二维码扫码登录

运行主程序。登录逻辑在 util/LoginUtil.py：二维码会以字符图案直接打印在终端里，用手机 QQ 扫，等终端出现"登录成功"。cookie 会存到本地，下次运行免扫码。

python main.py

登录成功后终端会打印你的 QQ 号和昵称，随后分页进度条开始滚动：每页 10 条、页间停 3 秒，耗时和数据量成正比，别以为它卡死了。

怎么判断导出成功

跑完的终端会输出"导出成功，请查看…"的提示，后面跟一串统计数字：消息总数、最早一条说说时间、好友数、说说/转发/留言条数、图片数。重点看"最早"时间——越接近你开通 QQ 空间的年份，说明这次 QQ 空间说说导出越完整。

数据从哪来、落到哪

程序从两处取数：互动消息列表（每页 10 条、页间停 3 秒）和可见未删除说说列表（util/GetAllMomentsUtil.py 实现，每页 30 条，带本地缓存，重跑不用重新下载）。两份结果按内容去重后合并，同一条说说不会被计两次；早期记录的时间有时缺秒数，解析时两种格式各试一次。所有文件统一落在 resource/result/你的QQ号/ 下：

文件	内容
QQ号_全部列表.xlsx	抓到的全部记录（含其他好友内容）
QQ号_说说列表.xlsx	你发布的原创说说
QQ号_转发列表.xlsx	你的转发记录
QQ号_留言列表.xlsx	你留下的留言
QQ号_其他列表.xlsx	其他好友的说说
QQ号_好友列表.xlsx	互动中出现的好友
QQ号_说说网页版.html	网页版时间线
pic/	说说图片，文件名取说说文本前 40 个字符

各表字段一致：时间、全文（前面带发布者昵称）、图片链接（多张以逗号分隔）、评论（时间、内容、评论人昵称与 QQ 号）。

卡住了看这里

启动提示"无法找到 zbar 共享库"：pyzbar 需要系统级 zbar 共享库，pip 装不了 → 用系统包管理器装 zbar 或 libzbar0，macOS 执行 brew 安装 zbar。
终端二维码花屏、扫不出来：字符式二维码在部分字体和终端下显示不完整 → 二维码同时以图片形式存在本地 temp 目录，打开那张图直接扫。
导出结果缺某些说说：工具只取"可见"范围内的记录，仅自己可见或已删除的不会拉取 → 这是机制边界不是故障，程序按内容去重，重跑是安全的。
运行很久像卡死：每 10 条消息停 3 秒，总耗时和数据量成正比 → 让它跑完；需要中断时按 Ctrl+C，已抓取的数据会先落盘。