用Python永久保存QQ空间历史说说：GetQzonehistory完整使用指南

用Python永久保存QQ空间历史说说：GetQzonehistory完整使用指南

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

你有没有想过，那些记录青春的QQ空间说说，某天可能再也打不开了？平台改版、账号异常、或是单纯的时间推移，都可能让这些珍贵的数字记忆悄悄消失。而QQ空间官方至今没有提供"一键导出全部说说"的功能。GetQzonehistory正是为解决这个痛点而生的Python开源工具，它能把你的历史说说、转发、留言、好友互动完整抓取下来，保存成Excel和网页文件，为记忆建一座永久的数字档案馆。

没有它和有它：QQ空间数据备份前后对比

先看最直观的变化。没有 GetQzonehistory 时，你想翻一条五年前的说说，只能一页页往下拉，手机端还会越翻越卡；想保存几张配图，得一张张截图或长按保存。有了它之后，你的所有数据会一次性落地到本地：

• 一份 Excel 全部列表：时间、正文、图片链接、评论，按时间排序，秒查任何一条历史记录
• 分类清晰的子表：说说、转发、留言、好友、其他内容各自独立成表
• 一个离线网页版：还原QQ空间风格的浏览界面，带头像、表情和评论区，双击就能看
• 全部配图自动下载：图片按说说内容命名，统一存进pic/文件夹，断网也能看

一句话总结：从"翻遍网页找不到"到"本地一键搜索"，这就是这个工具给你的核心价值。

从零到第一次成功导出：一步步带你跑通备份流程

下面模拟一位新手从拿到项目到导出第一批数据的完整过程，每一步我都会解释"为什么这么做"。

第一步：准备环境并克隆项目。项目运行在 Python 3.6+ 上，建议用虚拟环境隔离依赖：

git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory python -m venv myenv source myenv/bin/activate # Windows 用 myenv\Scripts\activate pip install -r requirements.txt

这一步把beautifulsoup4（解析网页）、pandas（生成Excel）、qrcode（登录二维码）、requests（网络请求）等依赖装齐。装完就能运行了。

第二步：运行主程序，扫码登录。

python main.py

程序启动后，util/LoginUtil.py会生成一个二维码打印在终端里。你用手机QQ扫一下，登录凭证会被自动保存到resource/user/目录，下次运行可以直接选择已登录账号，不用重复扫码。这里有个细节：工具内部通过 p_skey 计算出一个叫g_tk的校验参数（可以理解为登录后的"身份令牌"），所有后续请求都靠它通过腾讯的校验。

第三步：等待抓取与去重。登录成功后，util/RequestUtil.py会先二分估算你的消息总条数，再分批拉取历史消息列表——这是数据的主要来源，能找回大量平时翻不到的记录。接着util/GetAllMomentsUtil.py会再抓一遍当前空间可见的说说，补齐漏网之鱼，并和消息列表做智能去重。每抓10条程序会主动休息3秒，这是为了防止请求过于频繁被风控，属于自带的"冷静机制"。

第四步：查看导出结果。所有数据会写入resource/result/[你的QQ号]/目录，程序会自动打开文件夹。你至少会看到六份 Excel（全部列表、说说列表、转发列表、留言列表、好友列表、其他列表）和一个[QQ号]_说说网页版.html，图片则整整齐齐躺在pic/里。整个流程里，main.py是总指挥，util/ConfigUtil.py负责读写配置和目录，util/ToolsUtil.py提供HTML模板和QQ表情还原等杂活——五个模块各司其职，这就是你能放心一键跑通的原因。

进阶玩法：按你的场景选择正确姿势

场景一：只想快速备份，不想折腾环境。如果你不熟悉 Python 或不想建虚拟环境，可以直接用 README 里提到的 release 单文件版本，解压即用，登录后自动导出。适合"我今天就要备份"的急用场景。

场景二：数据量巨大，担心中断。好消息是程序内置了信号保护：你随时按Ctrl+C中断，它会把已抓到的数据先保存下来再退出，下次运行续上继续。建议在网络稳定的时段跑，别在高峰期折腾，遇到失败批次它也会自动跳过而不是崩溃。

场景三：想二次开发或研究爬虫思路。每个 util 模块都可以单独调用。比如你想扩展"只导出某年的说说"，可以改main.py里循环的分页逻辑；想定制 HTML 样式，直接改util/ToolsUtil.py里的模板即可。适合有编程基础、想折腾的玩家。

避坑指南：新手最容易踩的3个坑

坑一：终端里二维码显示不全，扫码失败。原因通常是终端字体或窗口宽度不够，二维码被截断。解决：把终端窗口拉宽，或调小字体；在 macOS 上如果提示找不到 zbar 库，按提示安装 Homebrew 后运行brew install zbar即可。

坑二：下载图片时报错或重名。部分历史消息里的图片链接可能已失效，程序会直接跳过这类图片，不影响其他数据。至于重名，工具会自动在文件名后追加时间戳，不用担心覆盖。

坑三：提示"登录失败"或二维码已失效。多半是二维码超时或系统时间不准。解决：确认系统时间与网络时间一致，重新运行python main.py生成新二维码，在倒计时内尽快扫码。

延伸思考：备份之外，它还能帮你做什么

抛开"备份"本身，这份结构化数据其实很有想象空间：你可以把多年说说导进数据分析工具，看看自己不同年龄段的心情关键词变化，绘制一条"情绪成长曲线"；也可以把好友列表和互动频率做成社交关系图谱，找出谁才是你真正的"铁哥们"。甚至基于 HTML 网页版，稍加改造就能做成一本送给朋友或自己的电子纪念册——数据一旦真正属于你，玩法就完全由你定义。

现在就开始：你的3步行动清单

1. 克隆项目并安装依赖（命令见上文，几分钟搞定）
2. 运行python main.py，手机QQ扫码登录
3. 等待导出完成，打开resource/result/欣赏你的数字记忆档案

项目地址：https://gitcode.com/GitHub_Trending/ge/GetQzonehistory ，更多细节见项目内README.MD。最后提醒一句：本工具仅供个人回忆保存与技术学习使用，请遵守相关法律法规和平台条款，尊重他人隐私，不要用备份的数据做任何不当用途。愿你的每一段青春，都能被好好珍藏。

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