QQ空间历史说说一键导出：扫码即用的 4 步本地备份方案
【免费下载链接】GetQzonehistory获取QQ空间发布的历史说说项目地址: https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
你翻相册看到 2014 年的一张合影，顺手去 QQ 空间找当年配的那条说说，历史消息里却怎么都搜不到。这类 QQ空间历史说说 其实没丢，只是界面不再展示而已。GetQzonehistory 就是干这个的：扫码登录，把历史记录导出成本地文件。
它能导出什么
GetQzonehistory 是一个 Python 脚本。输入只有一个 QQ 账号，登录靠扫码，不用密码；输出是 Excel、HTML 和图片，全部落在你本地。说白了，它把 QQ 空间不再展示的历史数据批量备份下来，存成你自己的数字资产。
数据是怎么落盘的
整条链路很短，登录、抓取、清洗、落盘，4 步走完：
- 扫码登录：生成二维码，手机 QQ 扫一下就过，不碰密码。
- 抓取：翻历史消息列表，每批 10 条取一页，直到取完。
- 清洗：本地去重，再补上当前还可见的说说。
- 落盘：拆成 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.txtmacOS 和 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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
