GetQzonehistory：把 QQ 空间历年说说批量导出为 Excel 与图片的方法

GetQzonehistory：把 QQ 空间历年说说批量导出为 Excel 与图片的方法

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

翻遍手机相册也找不到大学时发的那条说说，QQ 空间里的内容只能一条条翻看，没法整体带走。GetQzonehistory 是一个用 Python 编写的 QQ 空间历史说说备份工具：扫码登录后，它会把账号下的说说、转发、评论和图片逐批抓取下来，以 Excel 表格和图片文件的形式保存在你自己的电脑上。

📌 能力速览

• 扫码登录：使用 QQ 官方二维码登录接口，在终端生成二维码，全程不需要输入账号密码
• 批量抓取：按批次拉取说说、转发、评论、好友列表和图片，覆盖面包含 2014 年之前的老说说
• 多格式输出：一份备份包含多张 Excel 表、一个网页版 HTML 和一个图片目录
• 本地存储：所有请求与处理都在本机完成，结果直接写入项目目录
• 多账号支持：登录凭证缓存在resource/user/，再次运行时可选择已登录账号直接继续

和常见的保存方式相比，差别主要在这几项：

🚀 首次上手：从克隆到拿到备份

整条路径只有四步：

1. 克隆项目并安装依赖：

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 -r requirements.txt

2. 运行主程序：

python main.py

3. 终端会打印登录二维码，用手机 QQ 扫码确认。屏幕上会依次出现“二维码认证中”“登录成功”等状态提示；若提示“二维码已失效”，重新运行python main.py获取新码即可。
4. 等待抓取完成。程序按每批 10 条的节奏拉取历史消息列表，批与批之间有数秒间隔，并伴随进度条输出。登录成功后凭证会写入resource/user/，下次运行只需选择已有账号，无需再扫码。依赖较多时（如 macOS 缺少 zbar 库），按终端提示安装后再运行。

项目还发布了可直接执行的打包版本，如果不想搭环境，可以跳过上面的虚拟环境步骤。

📦 备份结果说明：导出文件在哪里

抓取结束后，所有结果统一存放在resource/result/你的QQ号/目录下（保存位置可在resource/config/config.ini中调整）：

• QQ号_全部列表.xlsx：所有内容的汇总，含时间、正文、图片链接、评论
• QQ号_说说列表.xlsx：仅本人发布的原创说说
• QQ号_转发列表.xlsx：转发内容的单独记录
• QQ号_留言列表.xlsx：空间留言
• QQ号_好友列表.xlsx：好友昵称、QQ 号、空间主页链接
• QQ号_其他列表.xlsx：他人发布、与自己互动相关的内容
• QQ号_说说网页版.html：还原时间线样式的网页，浏览器打开即可翻阅
• pic/目录：说说中所有图片的本地副本，按正文内容命名

程序结束时会在终端打印各类内容的总条数、最早一条说说的发布时间，并自动打开结果文件夹方便核对。

💡 典型用法

建立可检索的档案。把QQ号_全部列表.xlsx当作数据库使用：按年份筛选、按关键词搜索，都能直接做。想统计自己每年发了多少条，用 pandas 对“时间”列分组汇总即可，一两行代码的事。

重建个人时间线网页。直接用浏览器打开QQ号_说说网页版.html，内容和排版接近 QQ 空间原页面，转发与原创按时间合并排序，适合长期存档和偶尔翻阅。

图片集中归档。pic/目录下的图片文件名取自说说正文，方便和图片对应的内容互相定位。把它和个人照片库一起放进网盘或移动硬盘，等于多了一层离线副本。

❓ 常见问题

二维码过期了怎么办？终端显示“二维码已失效”后，重新运行python main.py就会生成新二维码，之前保存的登录缓存不受影响。

中途断掉能不能续？抓取过程中按 Ctrl+C 时，程序会自动把已获取的数据保存为 Excel 文件；重新运行时可选择resource/user/中已缓存的账号跳过扫码。

数据量大要跑多久？抓取按每批 10 条、批间暂停的节奏进行，几千条说说的账号可能需要数小时。建议插电、不休眠地连续运行，跑完后核对终端打印的总条数。

备份文件存在哪里？默认在项目目录的resource/result/你的QQ号/下。想换位置，编辑resource/config/config.ini中的result路径即可。

“仅自己可见”的说说能抓到吗？不能。工具抓取的是消息列表和可见说说列表中的数据，仅自己可见、已删除的内容不在范围内。

🔒 隐私边界

它做的事：

• 通过 QQ 官方二维码接口获取登录凭证，凭证只保存在本地resource/user/
• 只读取自己账号下的说说、评论、好友列表和图片
• 把抓取结果写入本机磁盘，不做任何格式外的二次上传

它不做的事：

• 不索取 QQ 账号密码
• 不向第三方服务器发送任何说说文本或图片
• 不点赞、不评论、不发送消息，只读不写

✅ 收尾清单

• 依赖安装后确认python main.py能正常打印二维码，再开始正式抓取
• 首次备份完成后，核对终端打印的条数与 Excel 行数是否一致
• 把resource/result/整个目录复制到移动硬盘或网盘，形成双份留存
• 不再使用时，可以删除resource/user/下的登录缓存文件
• 每隔半年左右再运行一次，把新增的说说补进备份

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