QQ空间历史说说一键导出：扫码即用的 4 步本地备份方案

QQ空间历史说说一键导出：扫码即用的 4 步本地备份方案

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

你翻相册看到 2014 年的一张合影，顺手去 QQ 空间找当年配的那条说说，历史消息里却怎么都搜不到。这类 QQ空间历史说说 其实没丢，只是界面不再展示而已。GetQzonehistory 就是干这个的：扫码登录，把历史记录导出成本地文件。

它能导出什么

GetQzonehistory 是一个 Python 脚本。输入只有一个 QQ 账号，登录靠扫码，不用密码；输出是 Excel、HTML 和图片，全部落在你本地。说白了，它把 QQ 空间不再展示的历史数据批量备份下来，存成你自己的数字资产。

数据是怎么落盘的

整条链路很短，登录、抓取、清洗、落盘，4 步走完：

1. 扫码登录：生成二维码，手机 QQ 扫一下就过，不碰密码。
2. 抓取：翻历史消息列表，每批 10 条取一页，直到取完。
3. 清洗：本地去重，再补上当前还可见的说说。
4. 落盘：拆成 Excel、HTML 和图片，写进 result 目录。

每一步失败都会把原因打印出来，看到报错先别慌，对照最后一章排查。

怎么把工具跑起来

克隆代码

先把仓库拉到本地，再进到项目目录：

git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory

装依赖

建议建一个虚拟环境，能避开本机依赖冲突。依赖清单都在 requirements.txt 里，一条命令装完：

python -m venv myenv source myenv/bin/activate pip install -r requirements.txt

macOS 和 Linux 用上面这条激活命令，Windows 换成 myenv\Scripts\activate 就行。

启动

跑主程序，终端会打印二维码，用手机 QQ 扫一下即可：

python main.py

登录逻辑在 LoginUtil.py，网络请求和抓取在 RequestUtil.py，想改行为看这两个文件就够。进度条走完自动存盘，说说少的账号几分钟就跑完，说得多会更久。第一次跑如果二维码出不来，多半是网络问题，换个网络重跑一次。中途按 Ctrl+C 也不会丢数据，已抓的部分会先保存。

导出目录里有哪些文件

文件都写在 resource/result/QQ号/ 下，一个账号一个目录。文件名前缀都是你的 QQ 号，多账号导出不会混：

• 完整列表：QQ号_全部列表.xlsx，消息列表全量记录，按时间排序。
• 说说：QQ号_说说列表.xlsx，你自己发的内容，带时间、内容、图片链接和评论。
• 转发：QQ号_转发列表.xlsx，转发内容单独存档。
• 留言：QQ号_留言列表.xlsx，好友给你的留言记录。
• 好友：QQ号_好友列表.xlsx，互动过的昵称和 QQ 号。
• 网页版：QQ号_说说网页版.html，浏览器打开就是还原后的时间线，表情也换回了图标。

每个 xlsx 字段都是：时间、内容、图片链接、评论，方便接着做表格处理。说说里的图片统一下到同目录的 pic/ 下，按内容命名，重名自动加时间戳，网页版里的图片走原图链接，有网就能看到。

高频问题怎么排查

扫码后一直转圈，或提示登录失败→ 登录态多半过期了。重新跑一遍 python main.py，再扫一次。

导出的条数比预期少→ 消息列表里没有的就取不到，仅自己可见的说说算这类。偶尔是网络丢了某一批，重跑一次能补回来。

部分图片没下下来→ 老图片链接已经 404。原始链接还留在 Excel 的图片链接列里，可以手动访问试试。

macOS 上报 zbar 相关的错→ 扫码组件缺系统依赖。执行 brew install zbar，再装一遍依赖。

Windows 终端中文乱码→ 控制台编码不对。先执行 chcp 65001，或者直接用 UTF-8 终端跑。

数据留在平台上，展示与否不由你说了算；落盘之后，备份才真正属于你。工具供个人备份使用，遵守 QQ 平台的相关条款就行。

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