企业官网建设流程全解析

如何一次性找回QQ空间全部历史说说？GetQzonehistory 使用教程

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

GetQzonehistory 是一个抓取并备份 QQ 空间历史说说的开源工具。扫码登录一次 QQ 后，它会把你账号下的说说、转发、留言和好友信息整理成本地 Excel 文件，并生成一个可离线浏览的网页版页面。全部数据在本地处理，不经过任何第三方服务器。

GetQzonehistory 运行效果：会导出哪些文件

运行 main.py 完成后，结果保存在resource/result/你的QQ号/目录下，程序结束时会自动打开该文件夹：

终端最后还会打印一份汇总：消息总条数、最早一条说说的时间、好友数、说说数、图片数。

环境要求与依赖安装步骤

本机装好 Python 3 即可，建议用虚拟环境运行，避免污染系统环境。

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 -i https://mirrors.aliyun.com/pypi/simple/ -r requirements.txt

注意：扫码登录依赖系统级的zbar库，首次启动若提示找不到该库，需要先安装（详见下文常见问题）。

QQ空间历史说说导出：逐步操作

1. 启动主程序

   python main.py

   终端会打印一个 ASCII 二维码，用 QQ 手机端扫码确认登录。如果resource/user/下已有之前登录过的账号，程序会列出已登录用户供选择复用，输入 0 则重新扫码。

2. 等待抓取完成

   登录成功后，程序先估算消息总量，再每 10 条一批拉取历史消息，每批之间有约 8 秒间隔。终端有进度条实时显示，消息量大时这一步最耗时。

3. 查看导出结果

   抓取结束后自动保存数据、打开结果目录并打印统计汇总。

导出结果说明：各文件字段与用途

• 全部列表.xlsx：四列——时间、内容、图片链接、评论，一行对应一条消息，是后续筛选、二次整理的总底表。
• 说说列表 / 转发列表.xlsx：从总表中按类型拆分，内容列采用“昵称：正文”的格式，便于单独分析自己发的内容。
• 留言列表 / 其他列表.xlsx：三列——时间、内容、图片链接，用于回看好友的互动记录。
• 好友列表.xlsx：昵称、QQ、空间主页三列，可核对互动过的联系人。
• 说说网页版.html：深色仿空间页面，按时间倒序排列。页面中图片链接指向原始高清图、头像来自 QQ 官方接口，因此打开时保持联网效果最完整。

核心原理速览：数据是怎么来的

整个流程是“登录 → 双数据源抓取 → 合并去重 → 分类导出”：

• LoginUtil.py 调用 QQ 官方扫码登录接口，终端解码并显示二维码，扫码成功后 cookie 缓存在resource/user/。
• RequestUtil.py 负责分页拉取 QQ 空间消息列表，每批 10 条。
• GetAllMomentsUtil.py 按每页 30 条获取当前可见的未删除说说，作为补充数据源。
• main.py 将两个数据源合并，用 ToolsUtil.py 中的is_any_mutual_exist逐条比对去重，再按说说、转发、留言、其他四类拆分导出，并生成网页版。

数据只有这两个来源，消息列表和可见说说里都没有的内容，工具拿不到。

常见问题与解决方法

问：启动时提示“无法找到 zbar 共享库”，二维码出不来。先安装系统 zbar：Linux 执行sudo apt install libzbar0（Fedora 系为sudo dnf install -y zbar），macOS 执行brew install zbar，装完重新启动程序。

问：为什么某些说说没抓到，比如早期的仅自己可见说说？工具只能拿到消息列表中出现过、或当前可见未删除的说说；仅自己可见和已删除的说说不在获取范围内，属于平台限制。

问：二维码过期或登录失败了怎么办？重新运行python main.py即可；在已登录用户列表界面输入 0 会触发重新扫码。

问：进度条走得慢，可以中断吗？每 10 条约 8 秒的间隔是刻意的限速。中途中止时程序会把已抓到的数据保存下来；注意重新运行会重新拉取消息列表，可见说说部分有本地缓存，不会重复请求。

收尾说明

GetQzonehistory 适合给自己账号做一次性的历史说说备份。两点边界要清楚：获取范围受限于“消息列表 + 可见说说”，仅自己可见和已删除的内容无法导出；登录态依赖 cookie，过期后需要重新扫码。个人学习与备份用途下，按上面的步骤走完一次即可。

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