QQ空间说说一键备份：GetQzonehistory导出工具实操指南

QQ空间说说一键备份：GetQzonehistory导出工具实操指南

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

你有没有想过，如果有一天打开QQ空间，发现十年前熬夜写的那些说说全都不见了，会是什么心情？平台改版、账号风险、服务器迁移……任何一次意外，都可能让你攒了多年的青春记录瞬间归零。别等失去才后悔，趁现在把数据握在自己手里，才是正经事。今天要介绍的 GetQzonehistory，正是一款帮你完成QQ空间说说备份的开源工具，它能把历史说说连同图片、评论一起搬回你的电脑，全程本地完成、无需付费，下面这份上手指南会带你一步步跑通整个流程。

先说痛点：为什么你的历史说说需要"搬家"

QQ空间承载了太多人的青春——初中的中二语录、大学的深夜感慨、毕业季的合影留言。这些内容平时看起来只是躺在云端的一串数据，但一旦账号被盗、内容被误删，或平台调整数据策略，就可能永久消失。

QQ空间数据备份的意义，不只是留个存档，而是把"平台说了算"变成"自己说了算"。GetQzonehistory 的思路很直接：登录你的账号，把可见的历史说说一条条抓下来，整理成表格和网页，存到本地硬盘。从此这份记忆不再依赖任何人的服务器。

功能速览：它能帮你拿回什么

先别急着装环境，花一分钟看看这个工具到底能产出什么，做到心里有数：

一句话总结：历史说说导出不只是导出文字，而是把文字、图片、互动关系打包成一套完整档案。

运行原理：它像一位代你跑腿的"记录员"

你可以把这个工具想象成一位戴着VR眼镜的记录员：你扫码授权后，他用自己的"眼睛"（模拟登录态）进入你的QQ空间，然后按时间线一页页翻看你的历史消息，看到一条就抄一条，图片单独下载，评论一并记录，最后把笔记整理成表格和网页交还给你。

具体到技术实现，整个流程分四步走：

1. 扫码登录：调用QQ官方登录接口生成二维码，你用手机QQ扫一下即可，全程不需要输入密码；
2. 估算总量：通过二分法探测消息总数，确定要翻多少页；
3. 分页抓取：每批拉取固定数量的消息，解析出时间、内容、图片、评论，还内置了每批间隔休息的逻辑，避免请求过快被风控；
4. 去重合并：工具会同时抓取"消息列表"和"未删除说说列表"两条通道的数据，合并时自动剔除重复项，保证既完整又不冗余。

对应到代码里，util/LoginUtil.py负责登录，util/RequestUtil.py负责发请求，util/GetAllMomentsUtil.py负责拉取未删除说说，util/ToolsUtil.py和main.py负责解析、渲染和落盘。想深挖细节的话，顺着这几个文件读就能看明白。

手把手实操：从零跑通第一次导出

下面按步骤走，预计10分钟内就能看到成果。

第一步：准备环境

确认电脑装了 Python 3.7 及以上版本，然后打开终端执行：

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

第二步：创建虚拟环境（推荐）

python -m venv myenv source myenv/bin/activate # Windows 下用 myenv\Scripts\activate

第三步：安装依赖

项目依赖了requests、beautifulsoup4、pandas、tqdm、Pillow、pyzbar等库，一次装齐：

pip install -r requirements.txt

小提示：如果你的网络访问默认源较慢，可以给 pip 加上国内镜像参数（如-i https://mirrors.aliyun.com/pypi/simple/），会快很多。

第四步：运行并扫码

python main.py

程序启动后会在终端打印一个 ASCII 码构成的二维码，同时把二维码图片保存到临时目录。用手机QQ扫码并确认登录，稍等片刻，终端就会显示"登录成功"，然后自动开始抓取。你会看到进度条和每批"Pause for 3 seconds"的提示，这是正常的节奏控制，耐心等它跑完即可。

如果你在 Linux 或 macOS 上遇到 zbar 库相关报错，按终端提示安装 zbar（如sudo dnf install -y zbar）即可，这一步只影响二维码的终端解码显示。

第五步：等待导出完成

抓取结束后，程序会自动打开结果目录，并打印一份统计：总消息数、最早一条说说的日期、好友数、各分类条数、图片张数等，看到这些就说明说说一键备份成功了。

结果验收：这样才算备份成功

导出完成后别急着关窗口，用下面这份清单逐项核对：

• resource/result/[你的QQ号]/目录下出现了多个 xlsx 文件（全部、说说、转发、留言、好友、其他列表）
• 出现一个"你的QQ号_说说网页版.html"文件，双击能在浏览器正常打开
• pic/文件夹里图片数量与终端打印的图片数一致
• 打开"说说列表.xlsx"，检查时间字段是否覆盖你的注册年限到最近一条说说
• 抽样翻几条早期说说，确认正文、表情、配图链接都在
• 网页版里点击图片能放大查看

只要上面任意一项不满足，多半是抓取过程中被风控或网络中断了——别慌，重跑一次程序即可，工具已抓到的数据会继续累积，不必从零再来。

高频问答与避坑贴士

Q1：能导出"仅自己可见"的说说吗？A：不能。工具只能获取消息列表中可见的内容，仅自己可见或已彻底删除的说说拿不到，这是QQ空间的权限限制，任何工具都一样。

Q2：导出很慢，正常吗？A：正常。每抓10条程序会刻意停顿几秒来降低风控概率，加上图片逐个下载，几千条说说跑上半小时到一小时都很常见。网络越稳，速度越快。

Q3：中途断电或误关终端，数据会丢吗？A：不会全丢。程序注册了信号处理，手动中断时会先把已抓取的数据保存下来；另外抓取过程中也有 JSON 缓存文件，重跑会自动续接。

Q4：会不会泄露我的密码或隐私？A：工具走的是扫码授权，不接触密码；数据全程在本机处理，不会上传到任何第三方服务器。但请务必从官方地址获取代码，避免下载到被植入后门的修改版。

避坑提醒（新手必看）：

• 别用太老版本的 Python，依赖库可能装不上；
• 抓取期间保持网络稳定，别频繁切换Wi-Fi；
• 结果目录是按QQ号隔离的，多账号使用时注意别选错登录用户；
• 工具仅供学习研究，请勿用于商业用途或骚扰他人，遵守平台规则。

进阶玩法：让备份数据发挥更大价值

基础导出只是第一步，这些数据完全可以玩出花来：

玩法一：年度回忆时间线用 pandas 读入"说说列表.xlsx"，按年份分组统计，就能做出"哪一年你发得最勤""每年最活跃的月份"这类个人数据报告。一句简单的data['时间'].str.extract(r'(\d{4})年')就能拆出年份列。

玩法二：照片整理成相册pic/目录下是按说说内容命名的图片，你可以按年份或关键词批量归拢到不同相册文件夹，配合fetch_all_message.py还能把说说渲染成 Markdown 长文，方便发博客或打印成册。

玩法三：二次开发改造项目结构清晰、模块化程度高，如果你想按时间段过滤、只导出图片说说、或换成别的输出格式，直接改main.py的保存逻辑即可。README 里作者也说明欢迎自行完善，这本身就是个很好的练手项目。

写在最后

数据这东西，存在别人服务器上叫"借"，存到自己硬盘里才叫"有"。现在花十几分钟做一次QQ空间数据备份，换来的是一份永远丢不了的青春档案。工具是免费的，教程是现成的，缺的只是你动手的这一刻。

趁说说还在，去备份吧。多年以后回头看，你会感谢今天按下回车键的自己。

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