GetQzonehistory 上手指南：5 分钟导出 QQ 空间历史说说
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
新手机里翻不到 QQ空间几年的老说说和评论。GetQzonehistory 是纯本地的 QQ 空间数据备份工具：QQ 扫码不输密码，把历史说说的内容和配图导出成 Excel 和网页版。
| 对比项 | 手动截图复制 | GetQzonehistory |
|---|---|---|
| 数据范围 | 零散几条 | 说说+评论+好友一次带走 |
| 图片 | 截图降质 | 直接下载并自动命名 |
| 登录 | 输入密码 | 官方扫码，不碰密码 |
30 秒跑起来
- 取代码并进入目录：
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这一步一次装齐核心包：requests 发请求、beautifulsoup4 解析页面、pandas 写 Excel、qrcode 生成二维码、tqdm 画进度条。
- 扫码登录，然后等进度条走完：
python main.py这一步终端里会打出字符拼成的二维码，用手机版 QQ 扫码确认；程序随后以每批 10 条、批间停 3 秒的节奏分页抓取，跑完自动归类、下载图片、生成网页版并打开结果文件夹。登录凭证以 cookie 形式落在resource/user/，第二次运行直接复用，不用再扫码。
跑完你手里有什么
所有结果集中在resource/result/你的QQ号/目录下：
| 文件 | 内容 |
|---|---|
| QQ号_全部列表.xlsx | 互动消息完整时间线 |
| QQ号_说说列表.xlsx | 你发布的原创说说 |
| QQ号_转发列表.xlsx | 你转发过的内容 |
| QQ号_留言列表.xlsx | 你收到的留言 |
| QQ号_好友列表.xlsx | 昵称、QQ、空间主页 |
| QQ号_其他列表.xlsx | 未归入以上分类的记录 |
| QQ号_说说网页版.html | 可视化时间线页面 |
| pic/ 目录 | 说说配图独立保存 |
图片以说说文本作为文件名，非法字符会被清理、超长截断到 40 字符，重名时自动追加时间戳防止覆盖。生成网页版时，图片链接会被尝试替换成高清版本，尽量保住画质。
它到底抓了哪些数据
抓取分两路，最后合并：一路是空间历史消息列表，每批 10 条、批间停 3 秒，这个刻意压低的节奏用来降低触发风控的概率；另一路是全部可见说说，拉取你空间里未删除、当前可见的清单，补上不在消息列表中的记录。两路内容会重叠，合并时按文本去重，避免 Excel 里出现重复行。
⚠️ 仅自己可见且未进入消息列表的说说拿不到，工具恢复的是"可见且在列表中"的上限。
扫码与凭证保存逻辑在 util/LoginUtil.py，分页抓取主逻辑在 main.py。
卡住了看这里
二维码过期扫不动—— 二维码有效期短，等待时失效了。终端打印"已失效"后重跑python main.py重新生成再扫。
进程中断后数据不全—— Ctrl+C 杀进程时，程序会先保存已抓取数据再退出，不算严格断点续传。已落盘的 Excel 是完整的，重跑一次补齐缺失部分即可。
Excel 打不开—— 多半是 WPS 或 Office 进程占用了文件。关掉相关窗口再打开；仍不行就用 pandas 的read_excel读一遍确认文件无损坏。
图片下载慢—— 批间 3 秒停顿是防风控设计，不是故障。个别图片下载失败属正常现象，重跑时会再次尝试。
让备份真正留得住
- 挑网络空闲时段跑，10Mbps 以上宽带能明显降低图片下载失败率。
- 提前估好磁盘空间，每 1000 条说说大约占 100MB，大头是图片。
- QQ 空间备份不是一锤子买卖，每季度全量跑一次，重要节点临时补跑。
- 把
resource/result纳入常规备份，至少存到两种不同的存储介质上。 - 关注项目更新，QQ 接口随时可能调整，版本落后会导致功能失效。
今天花 5 分钟跑一次，之后每季度补跑一次。
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
