GetQzonehistory指南：如何把QQ空间历史说说、留言和配图导出成6张表格加1个网页版
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
朋友的QQ空间被盗申诉找回，登录一看，互动列表只剩最近几十条。QQ空间没有官方数据导出入口，手抄手截图不现实。GetQzonehistory 是一个纯本地运行的 Python 工具：QQ 扫码登录，从历史消息列表和你自己可见的说说两条通道抓取说说、留言、转发和配图，自动去重合并，导出成本地 Excel 表格、图片目录和一个网页版，全程不碰密码。
哪些能拿回：先看清3条边界
- 能拿回：历史消息列表里还留着的互动记录（评论、点赞、转发、留言），加上你当前空间仍可见的说说。两条通道抓完自动去重合并，抓可见说说这一路走的是 util/GetAllMomentsUtil.py，能覆盖 2014 年之前的老说说。
- 拿不回：已彻底删除的说说；设为"仅自己可见"且从没出现在消息列表里的记录；平台规则调整后从列表里消失的老互动。
- 前置条件：一个能正常扫码登录的 QQ 号。工具上限就是"列表里还留着 + 空间里还看得见"，如果你已经发现列表被截短，越早跑越好。
边界清楚了，下面走一遍从装到出结果的最短路径。
从装到出结果的最短路径：4步
① 克隆仓库，建隔离环境
git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory python -m venv myenv跑完应看到当前目录多出一个myenv/文件夹，说明虚拟环境建好了。
② 激活环境，装依赖
⚠️ 激活命令分系统：Windows 用myenv\Scripts\activate，macOS/Linux 用source myenv/bin/activate。没激活就装，依赖会装进系统环境，后面全乱。
pip install -r requirements.txt跑完应无报错。共 11 个依赖，各管一摊：requests 发请求、pandas 出表格、qrcode 出二维码、tqdm 画进度条。其中 pyzbar 依赖系统的 zbar 库：Windows 装完即用；macOS 先执行brew install zbar；RPM 系 Linux 执行sudo dnf install -y zbar。
③ 启动，扫码
python main.py跑完终端应打印一个字符二维码（登录逻辑在 util/LoginUtil.py）。手机 QQ 扫码确认，看到"登录成功"即完成。cookie 存在本地resource/user/，下次运行选序号即可复用，不用重扫。
④ 等抓完
程序先用二分法估算消息总数，然后每批 10 条翻页，批与批固定停 3 秒。💡 这是防风控的节奏，几百条就是几分钟起步，别嫌慢。跑完终端直接给出汇总：消息总数、最早一条说说的时间、好友数、说说数、图片数。
跑完怎么验收：8个产出物加2个核对点
结果全部落在本地resource/result/你的QQ号/，程序会自动打开这个文件夹：
| 产出 | 里面是什么 |
|---|---|
| QQ号_全部列表.xlsx | 所有互动消息按时间排序的完整清单 |
| QQ号_说说列表.xlsx | 你发布的原创说说 |
| QQ号_转发列表.xlsx | 你转发过的内容 |
| QQ号_留言列表.xlsx | 收到的留言 |
| QQ号_好友列表.xlsx | 互动过好友的昵称、QQ号、空间主页 |
| QQ号_其他列表.xlsx | 未归类的剩余记录 |
| QQ号_说说网页版.html | 还原空间样式的可视化页面，双击即看 |
| pic/ 目录 | 说说配图，按内容命名，撞名自动加时间戳 |
两个核对点：
- 对数字：终端汇总的 4 个数（消息条数、最早说说时间、好友数、图片数）与 Excel 行数、pic/ 文件数一致，就算完整。
- 看网页版：打开 HTML，图片链接已自动换成高清版本（源文件里
/m/缩略图被替换成/s/原图），表情码被还原成表情图片。
对比手动备份：手截图一截就掉清晰度，评论互动基本丢光；这边一次扫码，时间、内容、配图、评论四样都进表格。如果只想要纯说说存档（Markdown 文本 + 高清图，不含互动分类），仓库里还有个独立入口 fetch_all_message.py 可单独跑。
验收过了，剩下的是容易绊住人的几处。
4个常见坑怎么修
现象：扫码没反应，终端打印"二维码已失效"。原因：二维码有有效期，扫晚了码就废了。对策：重新运行
python main.py出新码，同时确认手机和电脑网络通畅，登录请求没被代理工具拦掉。现象：启动时报"无法找到 zbar 共享库"。原因：系统缺二维码识别库 zbar，pip 装 pyzbar 装不出系统级依赖。对策：macOS 执行
brew install zbar，RPM 系 Linux 执行sudo dnf install -y zbar，装完重跑；Windows 一般 pip 装完即可。现象：中途提示"获取消息失败"或进度很慢，甚至你按了 Ctrl+C 担心丢数据。原因：每批 10 条、批间停 3 秒是防风控设计，个别批次返回空是正常的；中断本身有保护。对策：Ctrl+C 或进程被杀时，程序会先把已抓数据存盘再退出，重跑一次，落盘的 Excel 是完整的，不用从头抓。
现象：导出的 Excel 打不开。原因：文件正被 WPS 或 Office 占用锁定。对策：关掉占用程序重开；仍不行就用 pandas 读
.xlsx，数据本身没问题。
服务器那边的列表只会越收越短，硬盘里这一份已经落定。
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
