GetQzonehistory：三步本地备份 QQ 空间全部历史说说的完整指南
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
翻 QQ 空间时，你发现两年前的说说已经翻不到了，平台只显示最近的内容。GetQzonehistory 是一个纯 Python 的 QQ空间数据备份工具，它模拟扫码登录，把账号里散落的历史说说、留言、转发一次性抓回本地，解析成 Excel 和网页文件，全程不上传到任何服务器。
🎯 它到底能做什么
简单说，它替你做了一件你手动做不完的事：把 QQ 空间里翻不到、又不敢删的历史记录，变成你电脑里能随时打开的文件。对新手来说，它把"QQ空间历史说说怎么导出"这件麻烦事压缩成了扫码 + 等待两步。
- 多格式导出：同时产出 Excel 表格和网页版 HTML，图片单独落到
pic/文件夹，分析用表格、翻阅用网页，各取所需。 - 全程本地处理：从抓取、去重、分类到写文件，全在你自己的机器上完成，数据不出你的电脑。
- 扫码登录、免输密码：走 QQ 官方扫码流程，工具只负责显示二维码，你的账号密码从头到尾不交给它。
🧩 它是怎么做到的
数据有两个来源，工具把它们合并后再按内容查重，所以结果既全又不重复。
- 消息列表来源：
util/RequestUtil.py模拟浏览器分批拉取，每 10 条停 3 秒，把你账号收到的互动消息一条条取回来。 - 可见说说来源：
util/GetAllMomentsUtil.py再抓一遍账号下未删除的说说，用来补齐消息列表里没有的最新内容。 - 去重与落盘：两边比对去重后，
util/ToolsUtil.py负责解析 HTML、下载图片、套用网页模板，最后按你的 QQ 号分目录写出文件。
登录部分在util/LoginUtil.py：它生成一张官方二维码，你用手机 QQ 扫一下就完成登录，全程不碰密码。整个项目按职责拆成几个模块，结构长这样：
GetQzonehistory/ ├── util/ │ ├── LoginUtil.py # 扫码登录、二维码生成 │ ├── RequestUtil.py # 带 Cookie 的网络请求 │ ├── GetAllMomentsUtil.py # 抓取未删除的可见说说 │ ├── ToolsUtil.py # HTML 解析、图片下载、模板 │ └── ConfigUtil.py # 读取配置、保存登录态 ├── resource/ │ ├── config/config.ini # 文件保存路径配置 │ ├── result/ # 导出结果（按 QQ 号分目录） │ ├── temp/ # 运行缓存 │ └── user/ # 已登录用户的凭证 ├── main.py # 主程序入口 └── requirements.txt # 依赖清单🚀 从零到跑通
第一次用不用看源码，照下面四步走即可。
# 1. 克隆项目并进入目录 git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory # 2. 创建并激活虚拟环境 python -m venv myenv # Windows 激活： myenv\Scripts\activate # macOS / Linux 激活： source myenv/bin/activate # 3. 安装依赖 pip install -r requirements.txt # 4. 启动，按提示扫码 python main.py运行起来后它会弹出一个二维码，手机 QQ 扫一扫就开始抓取，终端里的进度条会实时滚动。用到的核心依赖不多，作用如下：
| 依赖包 | 用途 |
|---|---|
requests | 发起网络请求，拉取消息列表 |
beautifulsoup4 | 解析 QQ 空间返回的 HTML |
pandas | 整理数据并写出 Excel |
openpyxl | 支持.xlsx文件的读写 |
tqdm | 终端进度条显示 |
Pillow | 图片处理与二维码生成 |
另外qrcode、pyzbar、chardet等也会随requirements.txt一起装上，分别用于生成二维码、识别、编码探测，不用你单独处理。
📦 你会得到什么
全部产物放在resource/result/你的QQ号/目录下，文件名都以你的 QQ 号开头，方便区分。核心是下面这几类：
| 文件 | 内容 | 主要字段 |
|---|---|---|
QQ号_全部列表.xlsx | 抓到的全部消息 | 时间、内容、图片链接、评论 |
QQ号_说说列表.xlsx | 你自己发的说说 | 时间、内容、图片链接、评论 |
QQ号_转发列表.xlsx | 你转发的内容 | 时间、内容、图片链接、评论 |
QQ号_留言列表.xlsx | 你留给别人的留言 | 时间、内容、图片链接 |
QQ号_好友列表.xlsx | 有互动的好友 | 昵称、QQ、空间主页 |
QQ号_说说网页版.html | 网页版时间线 | 图文还原 QQ 空间排版 |
此外，所有图片会下载到同目录的pic/文件夹，文件名由内容生成、重名自动加时间戳；QQ号_其他列表.xlsx则单独收录别人发的内容，方便你把自己的和别人的分开看。
📈 不止是备份
拿到这些结构化数据后，可以做几件顺手的事：
- 按年看情绪：用
pandas读全部列表，按年份统计高频词，一眼看出自己哪一年话最多、哪一年情绪最低。 - 画关系图谱：拿好友列表叠加留言列表，统计谁出现次数最多，导给绘图工具就能画一张你的社交关系网。
- 做电子纪念册：直接打开网页版 HTML，换套 CSS 就是一条私人时间线，想打印或存成 PDF 都行。
⚠️ 使用注意与避坑
先说明：本项目仅限个人备份与技术研究使用，请遵守 QQ 平台规则，勿用于商业用途或侵犯他人权益。
- 节奏与网络：工具每 10 条停 3 秒，全程别断网；说说多时可能跑几十分钟，让它安静跑完。
- 存储预留：图片和表格会占一定空间，建议预留至少 500MB；跑完后
resource/temp/里的缓存可手动清理。 - 中断处理：手动
Ctrl+C会先把已抓到的数据存盘再退出；重跑会重新抓取，但登录凭证已存在resource/user/，不用再扫码。 - 凭证保管：
resource/user/里存着登录态，别把这个目录交给别人，导出结果也只放你信任的盘上。
❓ 常见问题
登录失败：
- 先确认能正常打开 QQ 空间网页版，排除网络被墙或断连。
- 二维码有时效，失效了重跑
python main.py生成新的即可。 - Linux 下若提示找不到
zbar库，先装系统包zbar再启动程序。
抓取中途断掉：
- 多为网络抖动，重跑即可，已保存的数据不会丢。
- 要手动停就按
Ctrl+C，它会先存盘再退出，别直接关终端。 - 图片多的账号占内存和磁盘，留意机器资源别被占满。
导出的文件打不开：
.xlsx需要装 Excel 或 WPS 等能读 xlsx 的软件。- 文件偏大时打开慢，稍等；先确认文件不是 0KB。
- 路径别放在网络盘或受限目录，本地固定目录最稳。
图片缺失：
- 老图片可能被平台删了，链接 404 就下不下来，属正常情况。
- 网络差会漏图，重跑时工具会跳过已下载的，只补齐剩下的。
- 文件名由内容生成、重名自动加时间戳，别手动改名导致对不上。
导出完成的那一刻，resource/result/里躺着的就是你的完整历史。接下来三步：克隆仓库、装依赖、扫码运行。
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
