GetQzonehistory 使用指南：QQ 空间历史说说导出的完整操作清单
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
GetQzonehistory 是一个面向普通用户的 QQ空间备份工具，能把 QQ 空间里的历史说说连同配图、评论一起保存下来，导出的内容适合整理与分析。全文按一次真实操作展开，不要求你会写代码。
为什么值得把 QQ 空间历史说说抢救下来
QQ 空间里存了不少年的文字和图片，却很难一次性搬走。说说、配图、评论分散在不同接口里，想手动备份几乎不现实；换设备或清理缓存后，很多年前的老内容还可能看不到了。一些工具要你先交出 QQ 密码，隐私上有顾虑；也有工具只能存文字，图片和评论都丢了；网络一抖，还得从头再来。对动辄几百条说说、上千张图的账号来说，靠截图根本追不上，这也是历史说说导出这件事长期没人认真做的原因。
GetQzonehistory 工作原理：扫码登录与自动抓取是怎么做的
GetQzonehistory 走的是 QQ 官方扫码登录，全程不经过你的密码。拿到会话后，它在 util/RequestUtil.py 里用一套模拟真实浏览器的请求头发起请求，降低被拦截的概率。
抓取的数据来自两条线，最后去重合并：一条是历史消息列表，由 RequestUtil 每 10 条一批往下翻；另一条是可见的未删除说说，由 util/GetAllMomentsUtil.py 每页 30 条翻页，这条路能一直回溯到 2014 年之前。分页是自动完成的——程序先估算总条数，再逐批翻页，你不用手动点下一页。
它支持断点续传：登录态会被写进 resource/user/，免重复扫码；已抓取的可见说会先缓存成文件，重新运行时直接复用；手动停止时也会先把已存的数据落盘，不会从零重来。整个过程中，抓到的数据都只留在你自己的机器上。
从克隆代码到备份完成：GetQzonehistory 完整操作实录
整个过程就是「拿到代码 → 准备独立运行环境 → 运行并扫码 → 等它导出」这四件事，下面按顺序走一遍。
先从仓库把代码下载到本地：
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.txtpython -m venv myenv创建一个叫 myenv 的隔离环境；激活它之后，命令行前面会出现 (myenv) 字样，说明你已在这个环境里；最后一条pip install从阿里云镜像下载并安装全部依赖，国内网络速度更快，requirements.txt 里列了本项目用到的全部第三方库。
环境就绪后，直接运行主程序：
python main.py运行后，如果 resource/user/ 里已有登录记录，会列出账号供你选择或重新登录；首次运行则直接在终端以字符形式打印一个二维码。用手机 QQ 扫码并确认，就像平时登录网页版 QQ 空间一样。登录成功后，程序会先估算你的历史消息总量，再每 10 条抓一批；消息列表抓完后，它会自动补齐可见的未删除说说并逐张下载配图、分类写入文件。看到「导出成功」字样，说明备份已经完成。
导出文件说明：QQ 空间备份会得到哪些 Excel 和图片
所有结果都放在resource/result/[你的QQ号]/目录下，打开能看到这样几样东西：
- 六个 Excel 文件：全部列表、说说列表、转发列表、留言列表、好友列表、其他列表。说说、转发、留言这几张表都带「时间、内容、图片链接、评论」字段，好友列表带「昵称、QQ、空间主页」。
- 一个 HTML 文件（说说网页版.html），双击就能在浏览器里按时间线回看，配图和评论都在。
- 一个 pic/ 子目录，把所有配图的原件按说说内容命名存进去；文件名最长取 40 个字符，重名会自动加时间戳避免覆盖。
避坑指南：历史说说导出前容易踩的几个坑
- 依赖装得慢或失败：优先走国内镜像源加速，装依赖那一步已经用了阿里云镜像；若你的网络下仍偏慢，可换成手头其他可用镜像。
- 提示缺少 zbar：个别 Linux / macOS 环境需要 zbar 组件，按终端里的提示安装后重新运行即可。
- 扫码失败：确认手机 QQ 已登录、二维码没有过期（终端会实时打印二维码状态）；失败后等几分钟再试，或清掉 resource/user/ 里的旧登录记录重新扫码。
- 图片没下载全：多是网络波动导致，去 pic/ 目录核对数量；缺的可以从 Excel 的「图片链接」列手动下载。
- 别乱关窗口：数据量大时，抓取加下载图片需要一些时间，每 10 条会主动停几秒降速；确实要停，按 Ctrl+C 让它先把已存数据落盘再退出。
不止于备份：用导出的说说数据做什么
导出来的数据不只是一份备份，还可以二次利用。
做个人时间轴：Excel 里每条都说清了几点几分发的、配了几张图、收到了哪些评论。你可以按年份或月份筛选，把重要节点挑出来，做成一条可视化的成长时间线；HTML 版本天然是时间轴形态，照着它排版就行。
做跨平台迁移：想把这些内容搬到个人博客或其他平台，Excel 适合批量处理（内容、时间、图片链接都是规整的列），HTML 版本保留了接近原站的视觉样式，可以作为迁移底稿继续改造。
隐私与安全：数据本地化处理与官方扫码登录
- 所有抓取、下载、导出都在本地完成，数据不上传到任何服务器。
- 登录用的是 QQ 官方扫码通道，程序不索取也不保存你的密码。
- 代码是开源的，逻辑可以逐行审查，各模块都在 util/ 下且注释齐全。
- 备份完成、确认无误后，可以把 resource/user/ 里的登录缓存删掉，减少本机留存。
如果你的 QQ 空间也有值得留下的内容，现在跑一次备份是最省心的选择。想调整抓取逻辑或加功能，从 util/ 下的模块入手即可，每个文件的职责在 README 里都有说明。
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
