GetQzonehistory:把QQ空间十年历史说说批量导出到Excel
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
GetQzonehistory 是一个用于 QQ空间备份 的 Python 脚本:把空间账号的历史说说、留言、转发和好友列表导出为 Excel,并额外生成一个可浏览的网页版。运行后文件落在resource/result/{QQ号}/目录,全程在本机完成,不经过任何第三方服务器。
QQ空间说说导出:安装与运行(最短路径)
前置条件
- Python ≥ 3.9
- Linux 系统需预装 zbar 共享库(终端解码二维码用);macOS 缺失时会在终端提示通过 Homebrew 安装
- 手机上 QQ 处于可扫码登录状态
三步跑起来
# 克隆项目并进入目录 git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory# 创建虚拟环境并安装依赖(激活:Windows 用 .\myenv\Scripts\activate,macOS/Linux 用 source myenv/bin/activate) python -m venv myenv pip install -r requirements.txt# 运行主程序 python main.py首次运行你会看到什么
首次运行时,终端会打印一个 ASCII 二维码,用手机 QQ 扫码即可;终端会持续刷新"二维码认证中/已失效/登录成功"状态。之前登录过则直接显示已保存的用户列表,按序号选择(输入 0 重新扫码)。登录成功后程序以每批 10 条的进度抓取消息列表,每批间隔约 3 秒,并打印进度条;结束后输出消息、说说、转发、留言、图片各自条数和最早一条说说的时间,并自动打开结果文件夹。说说量较大时(几千条消息)抓取阶段可能需要十几到几十分钟,保持终端开着即可。
导出产物说明:QQ空间数据本地备份会得到什么
所有文件都在resource/result/{QQ号}/下:
| 文件 | 格式 | 内容含义 |
|---|---|---|
| {QQ号}_全部列表.xlsx | xlsx | 消息列表全部条目:时间、内容、图片链接、评论 |
| {QQ号}_说说列表.xlsx | xlsx | 仅本账号发布的说说 |
| {QQ号}_转发列表.xlsx | xlsx | 本账号的转发记录 |
| {QQ号}_留言列表.xlsx | xlsx | 好友在你的说说上留下的评论 |
| {QQ号}_其他列表.xlsx | xlsx | 未归入上述类别的互动消息 |
| {QQ号}_好友列表.xlsx | xlsx | 互动好友的昵称、QQ 号、空间主页 |
| {QQ号}_说说网页版.html | html | 说说+转发按时间倒序合并的时间线页面 |
| pic/ | jpg | 说说中的图片 |
网页版是单个静态 HTML,用浏览器直接打开即可,版式接近 QQ 空间的信息流;想改配色、字号或排版,直接编辑文件即可。图片统一存放在pic/子目录,以说说内容前 40 个字符命名,重名时自动追加时间戳。
工作原理(精简版):QQ空间历史说说导出工具的数据链路
这是一个 Python QQ空间爬虫,数据来源是"双数据源":
- 扫码登录空间后,分批拉取消息列表——它是能触达深层历史的主要来源;
- 再全量拉取账号当前可见的未删除说说,补充未进入消息列表的条目;
- 两路数据按内容匹配去重后合并,写入 Excel/HTML 并下载图片,完成落盘。
边界与注意事项
哪些说说可能拿不到
从未出现在消息列表里的说说不一定拿得到,例如早年设为仅自己可见的早期帖子;已删除的说说两条链路都不会取到,工具只能覆盖"仍然可见"的内容。这是平台数据边界,不是程序问题。
跑了一半断了怎么办
按 Ctrl+C 中断时会先把已抓到的数据保存落盘;可见说说链路的原始数据有本地 JSON 缓存,重跑时不会重复请求,直接再执行python main.py即可继续。
网络慢时怎么处理
消息阶段每 10 条约 3 秒,消息量几千条时抓取本身就要几十分钟,属正常现象,耐心等待即可。若提示"登录失败"或二维码过期,重新扫码登录,已生成的缓存文件不受影响。
仓库内可进一步看的文件
- README.MD — 安装步骤与完整目录结构说明
- main.py — 主程序入口,抓取循环与数据落盘逻辑
- util/GetAllMomentsUtil.py — 可见说说的分页拉取与本地缓存实现
- util/LoginUtil.py — 二维码登录与 Cookie 处理
- requirements.txt — 依赖版本锁定清单
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考