GetQzonehistory 完整教程：免费导出 QQ 空间全部历史说说

GetQzonehistory 完整教程：免费导出 QQ 空间全部历史说说

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

免费 QQ 说说备份：跑完你能拿到什么

GetQzonehistory 是一款免费开源的 QQ 说说备份工具：手机 QQ 扫码一次，它就把你 QQ 空间的历史说说、转发、留言、评论和配图一次性抓下来，全部落到本地硬盘。跑完你会得到 6 张 Excel 表、一个可双击打开的离线 HTML 网页和一个高清图片文件夹。从克隆仓库到出现二维码，只需几分钟。

环境安装与启动一步到位

环境只需要 Python 3，Windows、macOS、Linux 都能跑。按下面这条命令流克隆并启动，装依赖慢就把 pip 那一行换成阿里云镜像源：

git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory python -m venv myenv source myenv/bin/activate pip install -r requirements.txt python main.py

Windows 上第四行改为myenv\Scripts\activate。不想配环境的话，仓库 release 里有打包好的单文件，可以直接执行。

主流程：跟着跑一遍

运行python main.py，按四步走完：

1. 终端会打印一个 ASCII 二维码，手机 QQ 扫码即完成登录，全程不输密码；出码后终端每几秒打印一次登录状态。
2. Cookie 按 QQ 号存进resource/user/下的文件，再次运行会列出已登录账号让你选序号，输 0 才是重新扫码。
3. 登录成功后进度条开始走：历史消息每批 10 条，批与批之间刻意停顿；可见说说接口每页 30 条，能补到 2014 年之前的老内容，两路合并去重后分类落盘。
4. 跑完控制台打印"导出成功"，自动打开resource/result/QQ号/文件夹，给出总条数、最早一条说说时间和图片张数；中途按Ctrl+C，已抓到的数据也会先存盘，下次接着跑。

原始请求按 QQ 号缓存在resource/fetch-all/下，重跑不会重复拉取，多账号互不串。

📦 产出物清单：逐项验收

GetQzonehistory 的全部产出都在resource/result/QQ号/里，对照下表验收：

每一行都带精确到秒的发布时间，图片 URL 独立占一列，评论按"谁、何时、说了什么"逐条拆开存，后续在 Excel 里筛选都很方便。说说网页版.html还原了头像、昵称、正文、配图和评论区，QQ 表情也换成了图片显示；双击就能离线看，渲染时还会把缩略图参数换成原图参数，点开即是大图。pic/目录里的图片是下载好的本地副本，哪天原链接失效，图还在你机器上。

覆盖边界：能拿什么、拿不到什么

• 数据来自两路："QQ 空间历史消息列表"和"未删除的可见说说"，只有这两路能看到的才进结果。
• "仅自己可见"的说说、消息列表之外的内容天然不在结果里，这是数据来源决定的上限，不是 bug。
• 2014 年之前的老说说由可见说说接口补齐，会进结果。
• 批间停顿是刻意限速，每批停几秒，消息越多总时长越长，属正常设计。

⚠️ 常见报错对照：卡住先查这里

卡住多半集中在依赖、登录、速度三类，先对照下表：

进阶玩法：统计与定时任务

备份落盘之后，数据还能这样用。fetch_all_message.py 是个轻量入口，单独运行能把全部可见说说另存成一份 Markdown，图片也一并下载。

用 Pandas 算出你的年度话痨月

Excel 列名是现成的，几行代码就能出统计：

import pandas as pd df = pd.read_excel('你的QQ号_说说列表.xlsx') df['时间'] = pd.to_datetime(df['时间'], format='%Y年%m月%d日 %H:%M:%S') print(df.groupby(df['时间'].dt.to_period('M')).size())

"内容"列是说说全文，再用str.len()可以找出最长的几条；往上还能加词频统计、配图数量随时间的变化，回忆就能变成一张图表。

让备份自己按时跑

Cookie 本地可复用，定时任务不需要再扫码，GetQzonehistory 也支持断点续跑，多次执行没问题。Linux/macOS 在 crontab 里加一行，每月 1 号凌晨 3 点自动跑一次；Windows 用任务计划程序做同样的事：

0 3 1 * * cd /path/to/GetQzonehistory && source myenv/bin/activate && python main.py

🔒 安全与红线

• 抓到的数据只写入你自己硬盘的resource/result/，不经过任何第三方服务器。
• 登录靠扫码，不收集密码；Cookie 就在resource/user/，不放心就删掉重扫。
• GetQzonehistory 全部代码开源可查：登录在 util/LoginUtil.py，请求在 util/RequestUtil.py，说说解析在 util/GetAllMomentsUtil.py，输出路径配置在 resource/config/config.ini。
• 红线：只备份你自己空间的内容，不要拿它去抓别人的数据；项目仅供学习与技术研究，不得用于商业或非法用途。

今晚克隆下来跑一遍，你空间里十年的说说和配图，就在自己硬盘上有第二份存档了。

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