GetQzonehistory 教程：三步免费导出QQ空间历史说说为Excel和网页

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

GetQzonehistory 是一款免费开源的QQ空间备份工具，能把QQ账号下可获取的全部历史说说导出为多张Excel表格、一个网页浏览版和本地图片文件夹。它通过扫码登录完成认证，不需要输入密码，适合想备份旧说说、整理社交历史或为研究做资料存档的用户。

📌 什么场景用得上：QQ空间说说备份的三个典型用途

换号、弃用账号之前先留档

如果你打算停用某个手机号，或某个QQ已经很少登录，建议先执行一次完整导出。号码一旦注销，账号数据会随之不可访问，历史说说将无从取回。而导出结果是本地文件，不受账号后续状态影响。

删除旧说说之前留一份副本

想清理空间、批量删除旧内容时，可以先跑一遍备份，把文字和图片都存下来。需要注意的是，已删除的说说无法被取回，所以"先备份、后删除"是唯一安全的顺序。

整理与分析：结构化数据更好用

导出表格里时间、内容、图片链接、评论分列存放，可以直接用Excel按年份、关键词筛选，也方便把内容按主题归类，或为写作、研究抽样整理资料。

🚀 三步上手：安装、扫码登录、等待导出完成

第一步：安装依赖并运行程序

克隆仓库后按 requirements.txt 安装依赖（包含 requests、pandas、beautifulsoup4 等库），再运行主入口即可：

git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory pip install -r requirements.txt python main.py

README 建议配合 Python 虚拟环境（隔离的运行环境，避免依赖冲突）使用。Linux 和 macOS 用户还需 zbar 组件来识别登录二维码，首次运行会检测并给出安装提示，macOS 上可借助 Homebrew 自动安装。另外，项目的 Release 页面提供打包好的单文件版本，可以跳过安装直接执行。

第二步：扫码登录，不输密码

程序启动后会向QQ登录服务器请求二维码，并在终端中显示出来，实现逻辑在 util/LoginUtil.py。用手机QQ扫码确认即可，全程不接触密码。登录成功后，Cookie（保存登录状态的本地凭证字符串）会写入 resource/user/ 目录；再次运行程序时，它会列出已登录用户，输入序号直接复用，输入 0 则重新扫码。

第三步：等待自动导出完成

登录后不需要手动操作。main.py 的主流程分两段：先以每批10条的节奏拉取QQ空间消息列表，批次之间内置停顿以避免高频请求；再调用 util/GetAllMomentsUtil.py 补充当前可见的未删除说说。两路数据按内容去重后统一写入文件。完成后程序会打印各类内容的条数、最早一条说说的时间，并自动打开结果文件夹。

📦 你会得到什么：QQ空间导出文件一览

所有文件按QQ号存放在 resource/result/{QQ号}/ 目录下：

除主流程外，还可以单独运行 fetch_all_message.py，它会按每页30条拉取全部可见未删除说说（含2014年之前的内容）、把图片下载到本地，并生成一份"所有可见说说.md"的Markdown文档，适合只想要文字和图片、不关心留言结构的用户。

可靠性说明：导出过程为什么可控

• 中断也能落盘：程序注册了信号处理，中途手动终止（如 Ctrl+C）时，已抓取的数据仍会写入文件，不会出现"跑了半天全作废"的情况。
• 本地处理、不碰密码：登录走官方扫码通道，Cookie 与抓取数据只保存在本机，不经过第三方服务。
• 编码与平台兼容：对返回内容自动检测字符编码，防止中文乱码；打开结果文件夹这一步在 Windows、macOS、Linux 上分别调用系统原生命令，代码里做了分支处理。

代码结构不复杂：main.py 负责主流程，util/ 下五个文件按登录、请求、配置、说说获取、通用工具划分职责，想改导出字段或HTML样式时容易定位到对应模块。

❓ 常见问题

问：能取回全部说说吗？答：数据源是QQ空间消息列表加当前可见未删除说说，两路合并去重。设为"仅自己可见"的说说不会出现在消息列表中，已被删除的说说也不在接口范围内，这两类都取不到。

问：对账号有什么要求？答：QQ账号处于正常使用状态即可，需要手机QQ能完成扫码。登录状态缓存在 resource/user/ 目录，之后运行选序号复用，输入 0 重新登录。

问：程序会上传数据吗？答：不会。Cookie、抓取数据和导出结果都只保存在本机。但导出文件包含说说全文和好友QQ号，resource/result/ 文件夹请妥善保管，不要随意公开。

问：Linux 或 macOS 上运行不了怎么办？答：多数情况是缺少 zbar 组件，扫码识别依赖它。首次运行会检测缺失并给出对应系统的安装命令，macOS 检测到 Homebrew 后可一键安装。

问：运行要多久？答：取决于消息总量。消息列表每批10条、批间停顿数秒，历史消息越多的账号耗时越长，让它完整跑完即可；中途手动终止时已抓部分仍会保存。

最后建议

建议现在就做一次完整导出，把 resource/result/ 文件夹复制到至少两个存储位置（本机硬盘加云盘或移动硬盘）；之后想更新时再跑一遍，用Excel按"时间"列筛选新旧即可对比增量。如果觉得本文有用，可以克隆仓库完成第一次导出，使用中遇到问题也可以回到开源项目反馈。

_{本工具仅供学习和技术研究使用，请遵守平台规则与法律法规。}

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