企业官网建设流程全解析

GetQzonehistory 快速上手：3 步把多年的 QQ 空间说说完整备份到本地

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

GetQzonehistory 是一款免费开源的 Python 小工具，专门抓取你 QQ 空间的历史说说。它用扫码登录替代账号密码，把每条说说的文字、时间、图片和评论导出为 Excel 表格和 HTML 网页，让几年的空间记忆完整留在自己电脑上。

30 秒速览

• 解决什么问题：把散落在 QQ 空间里的历史说说批量导出，不用再逐条截图、手动复制
• 给谁用：想给老账号做数据备份的普通 QQ 用户，会敲两三条命令就能跑
• 是否免费开源：完全免费，GPLv3 协议开源，代码可直接审查
• 支持哪些系统：Windows、macOS、Linux 均可（Linux 需额外装一个 zbar 依赖，后文会讲）
• 上手门槛：装好 Python 后 3 步跑通，登录方式是手机 QQ 扫二维码，不需要交出密码

最快上手：3 条命令跑通

环境要求一句话：电脑装有 Python 3.6 及以上版本，Linux 用户另外装好 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

第三步，运行主程序：

python main.py

跑成功的标志：终端先打印"用户<QQ号>,<昵称>登录成功"，抓取结束后出现"导出成功，请查看 resource/result/<QQ号> 文件夹内容"，同时自动弹出结果文件夹，里面是 Excel、图片和网页文件。

你能得到什么

所有产出都在resource/result/<你的QQ号>/文件夹下，按 QQ 号隔离，多账号互不混淆：

• 6 份 Excel 表格：全部列表、说说列表、转发列表、留言列表、好友列表、其他列表，字段统一为时间、内容、图片链接、评论
• 1 个 HTML 网页：QQ号_说说网页版.html，把说说和转发合并成可离线浏览的时间线，QQ 表情会还原成表情图
• 1 个 pic 图片目录：说说的配图自动下载，文件名取自说说内容，重名自动加时间戳
• 一份好友清单：抓取过程中出现过的空间好友昵称、QQ 号和主页链接

进阶用法

• 只要"未删除"的干净数据：项目里还有一个独立入口 fetch_all_message.py，它不走消息列表，直接分页拉取所有可见的未删除说说（含 2014 年以前的），最终生成一份所有可见说说.md并下载高清图，适合做二次整理
• 多账号切换：登录信息缓存在resource/user/目录，下次运行时程序会列出已登录账号让你选序号，输入 0 可重新扫码，方便帮家人备份不同 QQ
• 中途手动停止：在 main.py 里注册了信号处理，抓取途中按 Ctrl+C 会先把已有数据写盘再退出，不会白跑

它是怎么工作的

核心流程五步，源码都收在 util/ 目录里：

1. 扫码登录：终端打印二维码，手机 QQ 扫码确认，拿到登录凭证（逻辑在 util/LoginUtil.py）
2. 估算总量：通过二分法试探接口，确定历史消息总条数
3. 分批拉取：每批 10 条历史消息，解析出好友、时间、文本、图片链接，批间隔休息 3 秒降低请求压力
4. 补全说说：再调用说说接口分页获取未删除说说，与消息列表去重合并
5. 分类落盘：按内容把数据拆成六类 Excel，下载图片，渲染出 HTML 时间线

边界与注意

• 只抓"可见"数据：仅自己可见的说说、消息列表里没有的内容拿不到，作者也在 README 里明确说明
• 依赖网页版接口：原理是模拟登录 QQ 空间网页，若 QQ 调整接口格式，可能需要等作者更新
• 速度偏慢是有意设计：消息列表每 10 条歇 3 秒，账号存了上十年内容的，完整跑完需要耐心等待
• Linux 必须装 zbar：扫码解析依赖 pyzbar 和它底层的 zbar 库，缺了会直接退出并提示安装命令

常见问题

Q：扫码界面卡在"二维码已失效"怎么办？A：重新运行python main.py会生成新二维码，二维码有效期很短，出现后尽快扫。

Q：为什么导出的条数比我印象里少？A：工具抓的是消息列表加可见说说，设为"仅自己可见"、被删除或不在列表里的内容不会出现在结果里。

Q：Windows 上依赖装不上，报 zbar 相关错误？A：zbar 主要是 Linux 和 macOS 的坑，Windows 一般直接装 pip 包即可；仍失败时先检查 Python 版本是否为 64 位、版本是否过新。

Q：可以只备份文字、不下载图片吗？A：主程序没有开关，想省空间可以自行调整保存逻辑；或改用 Markdown 出口，图片按需处理。

下一步

1. 按"最快上手"一节把python main.py跑通，确认resource/result/里生成了你的 QQ 号文件夹
2. 打开 Excel 抽查最早的一批记录，用 HTML 网页版浏览时间线是否符合记忆
3. 把整个resource/result/目录复制一份到移动硬盘，完成双备份

仓库地址：https://gitcode.com/GitHub_Trending/ge/GetQzonehistory（仅 clone 时使用），项目说明见 README.MD。把备份做一次，之后的事就交给时间。

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