GetQzonehistory 完整指南：把QQ空间历史说说一步到位备份成 Excel

GetQzonehistory 完整指南：把QQ空间历史说说一步到位备份成 Excel

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

QQ空间没有官方导出入口，历史说说只能一条条复制或者截图。GetQzonehistory 是一个纯本地运行的 QQ空间说说备份工具，用官方扫码方式登录 QQ 后，它会自动翻页翻完历史消息列表和当前可见的说说，把内容、发布时间、配图和评论整理成 Excel 表格，外加一个仿空间样式的 HTML 页面。所有数据只写进你自己的硬盘，从克隆代码到拿到第一份表格约 10 分钟。

⚠️ 能拿到什么、拿不到什么：先说清楚

• 拿得到：历史消息列表里还存在的记录（说说、留言、转发等互动），加上主页上未删除、当前可见的全部说说，两条通道合并去重。
• 拿不到：没进过消息列表的说说（比如仅自己可见的）、已被彻底删除的说说，以及平台侧已丢失的记录。
• 一句话结论：能拿多少拿多少，早备份比晚备份多。

一次性准备：虚拟环境、装依赖、补 zbar

先把代码弄到本地，并建好独立环境：

git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory python -m venv myenv

剩下的事，对照这张表逐项完成：

💡 激活命令两个系统不一样，敲错了等于没建环境：

# Windows .\myenv\Scripts\activate # macOS / Linux source myenv/bin/activate

激活后执行安装：

pip install -r requirements.txt

zbar 方面：macOS 执行brew install zbar（程序检测到 Homebrew 时也可以自动帮你装），RPM 系 Linux 执行sudo dnf install -y zbar，Windows 一般装完 pip 包就能用。另外，README 里提到 release 页面提供了打包好的单文件版本，完全不想折腾环境可以直接跑它。

首次运行走一遍：从 python main.py 到导出完成

装好并运行

在激活的环境里敲这一行就行：

python main.py

怎么算成功：终端直接打印出一个字符二维码，没有中途报错退出。

扫码登录

用手机 QQ 扫这个码并确认。登录凭证以 cookie 形式保存在resource/user/目录里，下次再运行会先列出已登录的账号让你选，输入 0 才重新扫码。终端打印出"用户<QQ号>,<昵称>登录成功"，说明你进来了。

等它跑完

登录成功后，程序先探测历史消息总条数，然后每 10 条一批往下翻，每批之间刻意停 3 秒——这是防风控的节奏，进度条走得慢一点是正常现象，说说上千条的话等几分钟到几十分钟。

消息列表翻完后，它会顺手把主页上未删除、当前可见的说说（含较早年份的）也抓下来，与消息列表去重合并，再分类、下载配图、生成网页版页面，最后自动打开结果文件夹，Windows、macOS、Linux 都能正确唤起。✅ 看到"导出成功，请查看"加上一行文件夹路径，就是跑完了。

结果文件都在哪里：历史说说导出成 Excel 的位置

所有成果落在resource/result/你的QQ号/目录下：

resource/result/QQ号/ ├── QQ号_全部列表.xlsx ├── QQ号_说说列表.xlsx ├── QQ号_转发列表.xlsx ├── QQ号_留言列表.xlsx ├── QQ号_好友列表.xlsx ├── QQ号_其他列表.xlsx ├── QQ号_说说网页版.html └── pic/

还有两个藏在代码里的细节：pic/里的图片按说说内容命名，超长自动截断到 40 字符，重名时追加时间戳防覆盖，下载前程序还会把图片链接替换成高清版本。保存位置可以在resource/config/config.ini里调整，默认不用动。想批量下载QQ空间评论的话也不用另找工具，每条说说下的评论都已经写进表格第四列和 HTML 页面里了。

看到这 5 种情况别慌

如果看到"二维码已失效"或者扫码没反应 → 因为终端里的字符码有有效期，放久了就作废 → 处理：重新运行python main.py生成新码再扫，同时确认手机和电脑网络正常、没被代理工具拦截登录请求。

如果看到"无法找到 zbar 共享库"然后程序直接退出 → 因为系统缺少二维码识别依赖库 → 处理：macOS 执行brew install zbar，RPM 系 Linux 执行sudo dnf install -y zbar，装完重跑即可。

如果看到导出到一半断了，或者你自己按了 Ctrl+C → 因为网络波动或手动中止 → 处理：不用补数据，程序注册了中断保护，收到 Ctrl+C 或进程被终止时会先把已抓到的数据保存再退出，重新跑一次就行。

如果看到"登录失败"提示 → 因为登录状态失效或请求没走通 → 处理：重跑python main.py，resource/user/里已有账号记录就选对应序号复用，输入 0 重新扫码。

如果看到 Excel 文件双击打不开 → 因为文件正被其他程序占用 → 处理：先关掉开着的 WPS 或 Office 窗口再打开；仍不行就用在线表格或 pandas 读取同一个.xlsx，文件本身没问题。

📌 数据到手后的两个用法

做一份按年份翻的回忆册：打开全部列表.xlsx按年份筛选，哪一年去了哪座城、和谁互动最多，一条时间线全在表里。

给备份上双保险：把说说网页版.html转成 PDF 存网盘，或打印成实体纪念册；resource/result整个目录再复制一份到移动硬盘，多介质存放才算稳妥。

你的说说，就是你在 QQ 空间留下的痕迹。挪进自己说了算的硬盘里，这事就算办完了。

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