GetQzonehistory：QQ空间历史说说、留言与评论完整导出到本地
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
QQ空间从未提供数据导出入口；互动列表会被逐批截断；几年的说说没法手抄。GetQzonehistory 是一个纯本地运行的 Python 工具，用QQ官方登录二维码扫码，把QQ空间说说、留言、转发、评论与配图批量导出为本地表格和图片，全程不需要你的QQ密码。
三步跑通：环境、依赖、扫码登录
第一步：克隆仓库并建隔离环境。
git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory python -m venv myenvvenv是虚拟环境，可以理解为一个隔离目录：后面装的依赖都进这里，不会污染电脑上其他 Python 项目。
第二步：激活环境，安装依赖。
pip install -r requirements.txt先激活虚拟环境再装：Windows 执行myenv\Scripts\activate，macOS/Linux 执行source myenv/bin/activate。💡 依赖共 11 个（依赖即程序运行所需的第三方库），分工明确：requests 发请求、beautifulsoup4 解析页面、pandas 生成表格、qrcode 出登录二维码、pyzbar 识别二维码、tqdm 画进度条。其中 pyzbar 依赖系统的 zbar 共享库：Windows 一般装完即用；macOS 缺库时先执行brew install zbar；RPM 系 Linux 执行sudo dnf install -y zbar。
第三步：启动并扫码。
python main.py终端会打印一个字符二维码，用手机QQ扫掉并确认即可。登录成功后，程序先统计互动记录总数，再每批 10 条翻页抓取，批与批之间固定停 3 秒——这是防风控（QQ 的防自动化机制）的节奏，不要提速。进度条走完后，程序自动分类、下载配图、生成网页版，打开结果文件夹，终端同时给出汇总：消息条数、最早一条说说的时间、好友数、图片数。凭证以 cookie（登录状态凭证）形式存在resource/user/目录，下次直接复用，不用重扫。入口文件是 main.py，抓取、登录、工具函数分别在 util/ 下的模块里。
成果验收：表格、网页版与图片目录
所有成果落在resource/result/你的QQ号/目录下，跑完程序会自动打开该文件夹：
| 文件 | 内容 | 何时查看 |
|---|---|---|
QQ号_全部列表.xlsx | 按时间排序的全部互动消息，含时间、内容、图片链接、评论四列 | 进度条结束后直接打开 |
QQ号_说说列表.xlsx | 自己发布的原创说说 | 需要逐年翻看时 |
QQ号_转发列表.xlsx | 自己转发过的内容 | 需要逐年翻看时 |
QQ号_留言列表.xlsx | 收到的留言记录 | 想核对谁留过言时 |
QQ号_好友列表.xlsx | 互动好友的昵称、QQ、空间主页 | 做互动统计时 |
QQ号_其他列表.xlsx | 未归入上述几类的剩余记录 | 查漏时扫一遍 |
QQ号_说说网页版.html | 还原空间样式的可视化页面 | 归档或打印成 PDF 时 |
pic/目录 | 说说配图，按内容命名落盘 | 整理图片库时 |
对比手动截图加手抄：截图路线图片掉清晰度，评论互动基本存不下来，账号密码还得反复输入；这边一次扫码，时间、文字、配图、评论四样同时落盘，图片按原图下载、按内容命名，撞名自动加时间戳防覆盖，程序还会把图片链接改写为高清版本。所有数据只写本地磁盘，不经过任何第三方中转。
两条抓取通道的能力上限：覆盖范围与局限
程序实际走两条通道：历史消息列表，加上当前空间里仍可见的说说，两条通道抓完会自动去重合并。
能拿回：
- 历史消息列表里仍存在的互动记录：评论、点赞、转发、留言
- 当前空间里仍可见的说说
拿不回：
- 已经彻底删除的说说
- 设置为"仅自己可见"且从未出现在消息列表里的记录
- 平台规则调整后从列表里消失的老互动
工具的上限就是"列表里还留着 + 空间里还看得见"。只要消息列表还在，就尽早运行一次，越早跑，能留下的记录越多。
排障清单：症状→原因→动作
- ⚠️ 二维码扫了没反应 → 码已过期或登录请求被代理工具拦截 → 重新运行
python main.py出新码，检查手机与电脑网络是否通畅 - 启动或扫码时报 zbar 相关错误 → 系统缺二维码识别库 → macOS 执行
brew install zbar，RPM 系 Linux 执行sudo dnf install -y zbar，装完重跑 - 导出到一半中断（Ctrl+C 或进程被杀） → 正常中断 → 程序注册了中断处理，先保存已抓到的数据再退出，落盘的 Excel 完整，直接重跑
- Excel 打不开 → 文件被 WPS 或 Office 占用 → 关闭占用程序后重开；仍不行可改用在线表格，或用 pandas 读
.xlsx - ⚠️ 依赖下载慢或失败 → 默认源网络不佳 → 给 pip 加国内镜像源安装（README 中使用的是阿里云源）
导出之后：时间线、统计与离线存档
- 年度时间线：把"全部列表"按年份筛一遍，看哪年去了哪座城市、和谁互动最多，翻作年度回忆册。
- 好友互动统计：用数据透视表统计每位好友的互动频次与最近一次互动时间，关系走向一目了然。
- 离线存档：把整个
result目录复制到移动硬盘，网页版 HTML 可再转 PDF 单独存放一份，多介质多位置才算稳妥。 - ✅习惯：每季度全量跑一遍，发现QQ接口有调整就跟进项目仓库的更新。
写在最后
数据不再只寄存在别人的服务器上，硬盘里这一份，归你管。
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
