当前位置：首页 > news >正文

3 步永久保存 QQ 空间历史说说备份：GetQzonehistory 完整使用指南

news 2026/8/16 20:12:44

3 步永久保存 QQ 空间历史说说备份：GetQzonehistory 完整使用指南

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

先说好，这篇不是千篇一律的"项目介绍 + 功能列表"模板文，而是一趟跟着真实场景走完的"抢救回忆"全流程。你会跟着一个普通用户的视角，从"深夜翻空间却发现回忆正在变模糊"开始，一步步把 QQ 空间历史说说备份变成看得见、摸得着的本地档案。

一次深夜怀旧，让我决心把 QQ 空间历史记录全部搬回家

上周我失眠，随手点开自己的 QQ 空间想翻翻十年前的说说。结果翻到第三页就卡住了——越往上翻，加载越慢，很多早期的说说要么只剩文字、图片裂掉，要么干脆提示"内容不存在"。我试着截图保存，可几千条说说靠手翻根本不现实。

更扎心的是，官方一直没有提供 QQ 空间历史记录导出功能。平台规则在变、图片服务器会清理、账号一旦出问题，那些记录着学生时代心情的说说就可能彻底消失。那一刻我意识到：与其等数据消失，不如主动给 QQ 空间历史说说做一次完整备份。

于是我找到了GetQzonehistory——一个专门用来获取 QQ 空间发布的历史说说并生成本地档案的 Python 工具。它不需要输入密码，扫码就能登录；不需要手动复制粘贴，跑完自动导出 Excel、HTML 和全部图片。下面是它的完整工作流程：

动手前先看懂：这套备份工具凭什么能捞回十年说说

GetQzonehistory 的思路并不复杂，核心就一句话：通过模拟登录 QQ 空间，把"消息中心"里所有历史互动记录全部拉回来，再和你空间里当前可见的说说合并去重，最终整理成本地文件。它不修改、不删除你的任何线上数据，只做"读取 + 存档"。

整个项目采用分层结构，每个模块只干一件事：

模块文件	负责什么	一句话理解
`LoginUtil.py`	扫码登录与凭证管理	生成二维码、换取 cookie，并缓存登录状态
`RequestUtil.py`	网络请求封装	负责拉取历史消息列表、统计消息总数
`GetAllMomentsUtil.py`	可见说说抓取	补充获取当前空间里未删除的说说
`ConfigUtil.py`	配置与目录管理	管理保存路径、多账号登录选择
`ToolsUtil.py`	工具函数	HTML 模板渲染、表情解析、文件读写

两个数据来源加起来，能覆盖大多数历史内容；再加上智能去重逻辑，同一句话不会被重复保存。这正是它比"手动翻页截图"靠谱得多的原因。

从零开始 3 步完成 QQ 空间历史说说备份（新手照抄版）

整个备份过程真的只需要 3 步，我按最稳妥的方式给你拆开讲，全程傻瓜式操作。

第 1 步：克隆项目并准备 Python 环境

先确认你的电脑上有Python 3.6 或更高版本（输入python --version即可查看），然后打开终端执行：

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

创建虚拟环境是为了不污染你电脑上其他的 Python 项目，强烈推荐。创建好后激活它：

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

第 2 步：一键安装依赖

pip install -i https://mirrors.aliyun.com/pypi/simple/ -r requirements.txt

依赖清单里包括requests（网络请求）、beautifulsoup4（HTML 解析）、pandas（生成 Excel）、qrcode+Pillow（登录二维码）等，装一次以后都不用再管。

💡 如果你在国内网络环境下安装超时，把命令里的镜像源换成清华源（https://pypi.tuna.tsinghua.edu.cn/simple）即可。

第 3 步：运行主程序，扫码完成 QQ 空间登录备份

python main.py

运行后终端里会出现一个 ASCII 版二维码，用手机 QQ 扫一扫即可登录。程序会自动保存登录 cookie，下次再跑同一账号时，会直接询问你选择哪个已登录用户，不用重新扫码。

登录成功后，剩下的就是等待。程序会分批抓取历史消息，并实时打印进度；跑完后自动打开导出目录，你的 QQ 空间历史说说备份就完成了。

导出目录里长这样：

备份完成后你能拿到什么？一份会"说话"的数字档案

很多人以为备份 = 一个 Excel，其实 GetQzonehistory 给的是一整套分类档案。以你的 QQ 号为文件夹名，里面包含：

文件	内容
`QQ号_全部列表.xlsx`	所有历史消息的完整记录
`QQ号_说说列表.xlsx`	你本人发布的说（含时间、正文、图片链接、评论）
`QQ号_转发列表.xlsx`	转发内容及原始信息
`QQ号_留言列表.xlsx`	好友的留言存档
`QQ号_好友列表.xlsx`	互动过的好友昵称、QQ 号、空间主页
`QQ号_说说网页版.html`	按时间倒序渲染的网页版空间，还原原貌
`pic/`文件夹	自动下载的全部说说配图

每条说说都包含精确到秒的发布时间、完整正文（连表情都还原）、图片原始链接以及评论互动明细（昵称、内容、时间）。Excel 方便你随时检索、筛选、做数据分析；HTML 文件双击就能离线浏览，体验接近当年网页版 QQ 空间。

核心亮点深挖：四个设计细节，帮你省掉大量手工活

亮点一：双重抓取，最大限度抢救隐藏内容 🎯

只靠"消息中心"会漏掉部分内容，只靠"当前可见说说"又抓不全早年数据。GetQzonehistory 把两条路都走了，再自动合并去重，把能恢复的记录尽量都捞回来。

亮点二：图片自动下载，并按内容智能命名 📸

说说里的每张图片都会被自动下载到pic/目录，文件名直接用说说的正文内容生成，一眼就能认出这张图是哪条说说的。遇到重名会自动加时间戳后缀，不会互相覆盖。

亮点三：意外中断不白跑，手动停止也能保存 🛡️

程序给中断信号做了处理：哪怕你中途按Ctrl+C强行停止，已经抓到的数据也会先保存到本地再退出。数据量大的时候，这个细节能救回你不少功夫。

亮点四：多账号登录缓存，切换账号零成本 👥

登录凭证按 QQ 号单独保存在本地，下次运行时直接列出已登录用户让你选择。帮家人备份、或者切换小号，都不需要重新扫码。

进阶玩法：一条隐藏命令，解锁 Markdown 与全量高清图

如果你不满足于 Excel + HTML，项目里还藏着一个独立脚本fetch_all_message.py，它会把所有可见说说（包含 2014 年之前的）连同高清图片一起导出成一份完整的 Markdown 文件，非常适合后续二次编辑或导入笔记软件：

python fetch_all_message.py

脚本会先拉取说说总数，再分页抓取每一条，图片以"说说 ID + 序号"命名保存，转发内容用引用块、评论用列表清晰呈现，Markdown 结构对写作者非常友好。

另外，抓取过程中的中间数据（JSON 缓存）会保留在resource/fetch-all/目录下，即使中途断了，重跑也能从缓存续上，不用从头再来。

避坑指南：5 个高频问题一站式排查方案

新手最容易在下面几个地方卡住，我把解法提前给你：

Linux/macOS 报"无法找到 zbar 共享库"这是二维码解码库缺失。Linux 执行sudo dnf install -y zbar（Debian 系换成sudo apt install libzbar0）；macOS 用brew install zbar，装完重新运行即可。
二维码一直显示"认证中"或"已失效"先确认系统时间是否准确，再确认网络稳定，然后重新运行程序生成新二维码。手机 QQ 扫码后耐心等 3 秒轮询结果。
部分说说始终备份不到消息列表里没有的内容（比如仅自己可见的说说）本来就拿不到，这是平台限制，不是工具 bug，README 里也明确说明了。
依赖安装很慢或失败换国内镜像源安装（上面给过命令），一次不行就多试两次，网络波动很正常。
导出后个别图片打不开图片链接是原始地址，极少数远古图片可能已被平台清理。这是客观存在的限制，正文和评论文字不受影响。