用GetQzonehistory完整备份QQ空间历史说说：从零到一跑通全流程的6个关键步骤

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

"我的QQ空间，还能撑多久？"那天深夜，我翻着十年前的说说，突然冒出一个念头。那些记录着高考前夜失眠、大学寝室合照、第一次旅行惊喜的文字和照片，是我青春最真实的切片。可网络世界没有"永久"二字——平台改版、账号异常、链接失效，任何一次意外都可能让这些记忆灰飞烟灭。GetQzonehistory正是为这个焦虑而生的开源工具：它通过模拟登录QQ空间，自动抓取账号下发布过的历史说说，并将文字、图片、评论完整导出到本地，让你真正拥有自己的数字记忆。备份，是成本最低的安心。

一、先看看这个工具能给你什么：一份"记忆保险箱"的开箱清单

在动手之前，不妨先弄清楚GetQzonehistory到底能帮你拿到什么。把它想象成一个"记忆搬运工"：它潜入你的QQ空间，把散落的说说一件件打包，搬进你自家的仓库。它的核心能力就三个字：全、清、稳。

1.1 它能抓回什么：说说、转发、留言、好友，一网打尽

运行完成后，你会在本地拿到一份按QQ号命名的文件夹，里面躺着六类成果：

• 说说列表：你自己发布的全部可见说说，含精确到秒的发布时间、完整文本、图片链接和评论
• 转发列表：你转发过的所有动态，原样保留
• 留言列表：空间留言板里的互动记录
• 好友列表：互动好友的昵称、QQ号和空间主页地址
• 网页版HTML：一键还原QQ空间浏览体验的离线页面
• 图片目录：说说附带的所有图片，自动下载到本地pic/文件夹

1.2 两个入口，两种深度：main.py 与 fetch_all_message.py

项目提供了两条抓取路线，理解它们的分工能让你选对工具：

• python main.py：走"历史消息列表"接口，覆盖面广，能拿到互动消息、留言、转发等完整脉络
• python fetch_all_message.py：走"说说列表"接口，专门补齐未删除的可见说说（包括2014年之前的早期内容），并下载高清图片

打个比方：main.py像全景相机，拍下你空间的整体面貌；fetch_all_message.py像微距镜头，专挑珍贵细节。两者配合使用，备份才算完整。

上图是GetQzonehistory的工作流程图：从扫码登录出发，依次完成数据获取、解析处理、结果导出，中途遇到异常会自动分支处理，最终把成果落盘。

二、动手前先踩点：环境准备与安装部署全流程

工具再好，装不上等于零。这一节我们像搭积木一样，把运行环境一步步搭起来。别怕命令行，你只需要会复制粘贴。

2.1 把项目拿到本地：两条路任选

最简单的办法，是把仓库克隆到本地：

git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory cd GetQzonehistory

如果git用得不熟，也可以直接在页面上点击"下载ZIP"，解压到任意目录，效果一样。关键是后续的命令都要在项目目录内执行。

2.2 创建虚拟环境：给依赖一个"独立房间"

直接往系统Python里装包，就像往合租房的公共区域乱放行李，迟早打架。虚拟环境相当于给本项目开了一间独立房间：

python -m venv myenv

创建好后激活它：

# Windows用户 .\myenv\Scripts\activate # macOS / Linux用户 source myenv/bin/activate

激活成功后，你的命令行前面会出现(myenv)字样，代表"你现在住进了独立房间"。

2.3 安装依赖：一条命令装齐所有零件

项目用到的BeautifulSoup4（解析网页）、Pandas（处理数据）、Requests（发请求）、openpyxl（写Excel）等，都写在requirements.txt里。一条命令全部装好：

pip install -i https://mirrors.aliyun.com/pypi/simple/ -r requirements.txt

国内网络环境建议保留-i参数走阿里云镜像，速度会快很多。

2.4 可能的坑：Linux/macOS 需要 zbar 库

如果你在Linux或macOS上运行，可能遇到一个提示：找不到zbar共享库。这是二维码解码需要的底层组件，安装方式按系统不同：

# Fedora / RHEL系 sudo dnf install -y zbar # macOS（需先装Homebrew） brew install zbar

装完再跑一次，就畅通了。Windows用户一般不会遇到这个坑。

三、第一次见面：扫码登录与初始化配置详解

环境就绪，万事俱备。现在运行主程序，和你的QQ空间来一次"安全握手"。

3.1 跑起来：一行命令开启备份之旅

python main.py

程序启动后，会先在resource/temp/下生成一张登录二维码，并直接在终端里用字符画打印出来。

3.2 用手机QQ扫码：无需密码的安全登录

掏出手机QQ，扫描终端里的二维码，确认登录即可。整个过程不需要输入密码，登录凭证以cookie形式保存在resource/user/目录下。这既避免了密码泄露风险，也让下次运行省去重复扫码的麻烦。

3.3 记住登录状态：下次运行自动识别

程序会在下次启动时自动检测本地已保存的用户信息，列出已登录的QQ列表让你选择：

已登录用户列表: 1. 10001 请选择要登录的用户序号，重新登录输入0:

输入序号直接继续，输入0则重新扫码。这个设计很贴心：多账号用户也能来回切换备份。

四、实战演练：从登录到拿到全部说说的一次完整走查

理论说再多，不如亲手跑一遍。下面我用一条完整主线，带你走完"登录→抓取→导出→查看"全流程。

4.1 第一阶段：登录并确认身份

运行python main.py，扫码登录成功后，终端会打印：

用户<你的QQ号>,<你的昵称>登录成功

看到这行字，说明你的"通行证"已经生效，程序开始统计消息总量。

4.2 第二阶段：耐心等待自动抓取

接下来程序会自动分页抓取历史消息，每10条一批，每批之间主动休息3秒——这是为了降低请求频率、减少被风控的概率。终端会显示进度条：

Progress: 45%|████▌ | 9/20 [00:54<01:06, 6.02s/10条]

这里最需要的是耐心。说说越多，耗时越长。几百条可能要十几分钟，几千条则要等上一小时。中途想停止？按Ctrl+C，程序会先把已抓到的数据保存下来再退出，不会白跑。

4.3 第三阶段：自动补全可见说说

main.py抓完互动消息后，还会调用"未删除说说"接口做一次补全，去重合并后统一处理。这个环节让备份更完整——消息列表里可能缺的内容，在这里被补回来。

4.4 第四阶段：导出成果并自动打开文件夹

抓取结束后，程序会依次生成各份Excel和HTML文件，下载全部图片，然后自动用系统默认程序打开结果目录。终端会打印一份"成绩单"：

导出成功，请查看 resource/result/你的QQ号 文件夹内容 共有 1568 条消息 最早的一条说说发布在2012年09月13日 22:15:36 好友列表共有 312 个好友 说说列表共有 1203 条说说 转发列表共有 216 条转发 留言列表共有 89 条留言 图片列表共有 486 张图片

那一刻，看着"2012年"这个时间戳，很多人会恍惚——原来自己已经写了这么多年的说说。

五、导出结果怎么用：从Excel到网页版的"记忆博物馆"

备份不是终点，能看、能用、能分析才是价值所在。GetQzonehistory把成果做成了多种形态，任你挑选。

上图是GetQzonehistory的导出结构：以QQ号为文件夹名，在resource/result/下生成多份Excel表格、一份网页版HTML，以及独立的图片目录pic/。

5.1 Excel表格：数据分析的富矿

以你的QQ号命名的Excel文件，每一行是一条记录，包含四列：时间、内容、图片链接、评论。这意味着你可以用任何表格软件或Python对它做任意分析：按年份统计发布频率、找出最活跃的月份、回顾某年某月的自己。这是属于你的个人大数据。

5.2 网页版HTML：还原QQ空间的浏览体验

程序会生成一份"说说网页版.html"，用深色卡片还原空间动态的排版：头像、昵称、时间、正文、图片九宫格、评论区，一应俱全。双击打开，就像回到了当年的空间页面，连QQ表情都会被还原成小图标。它比截图更完整，比Excel更亲切。

5.3 图片目录：原图级别的照片保险

pic/目录里躺着所有说说配图，文件名取自说说内容的关键词，方便查找。即使将来QQ空间的图片链接全部失效，这些照片也已经安安稳稳躺在你硬盘里了。

5.4 进阶：用Pandas深挖自己的"成长数据"

技术爱好者可以更进一步，用Pandas把备份数据变成可视化回忆：

import pandas as pd df = pd.read_excel('你的QQ号_说说列表.xlsx') # 读取说说列表 df['发布时间'] = pd.to_datetime(df['时间']) # 时间列转成标准格式 df['年份'] = df['发布时间'].dt.year # 提取年份 print(df['年份'].value_counts().sort_index()) # 看看每年发了几条

三行代码，就能得到一张"我的年度活跃度曲线"——哪年话痨、哪年沉默，一目了然。

六、新手避坑清单：6个高频问题一次说清

实践出真知。这里把新手最容易踩的坑提前摆出来，帮你省下排查时间。

1. 扫码后提示登录失败？先看手机QQ是否已登录、网络是否正常，再确认系统时间准确。二维码有时效性，失效了就重新运行程序生成新的。

2. 登录后立刻断开？可能是QQ的安全策略在干预。等几分钟再重试，同时避免在多个设备同时登录QQ空间。

3. 只能抓到一部分说说？网络波动或接口限流都可能导致中断。别慌，重新运行即可——程序支持断点续抓，已经缓存的数据不会重复获取。

4. 图片下载失败？多半是图片链接失效或网络问题。可以稍后单独用Excel里的图片链接手动下载，也可以检查pic/目录是否有写权限。

5. 安装依赖报错？先确认Python版本在3.6以上，再检查是不是网络问题——换成国内镜像源通常能解决。

6. 运行太慢？说说数量多时本就耗时，程序内置的3秒间隔是防风控的保护措施，不建议去掉。泡杯茶，让进度条慢慢走。

七、安全与隐私：你的数据只属于你自己

用这类工具，最关心的一定是安全问题。放心，GetQzonehistory在隐私保护上做了周全设计：

7.1 三个"不上传"原则

• 数据不上传：所有抓取和导出都在本地完成，结果只落在你的硬盘上
• 密码不收集：登录走官方扫码通道，全程不接触QQ密码
• 代码可审查：项目完全开源，每一个请求、每一行逻辑都能被公开检验

7.2 三条使用建议

1. 备份完成后，可删除resource/user/下的登录缓存，避免凭证长期留存在本地
2. 重要的备份文件建议加密存储，或复制到移动硬盘、加密云盘，做到多地备份
3. 关注项目更新，及时获取安全修复与功能改进

7.3 一点提醒

工具仅供学习和个人数据备份使用，请勿用于任何商业或非法用途。尊重他人隐私，不抓取不属于你的内容——这是使用任何工具的底线。

八、让备份变成习惯：应用场景与价值延伸

备份一次容易，坚持备份难。但GetQzonehistory的价值，恰恰藏在"长期主义"里。

• 毕业季前：把四年的社团、旅行、深夜食堂都打包一份，当作送给自己的毕业礼
• 每年年初：把过去一年的说说导出归档，形成年度回忆册
• 迁移内容：把Excel数据导入博客、日记App或其他平台，让内容换个地方继续发光
• 数据分析：用Pandas统计高频词汇、情感倾向，给自己做一份"数字人格报告"

记住一个原则：备份的最佳时机永远是现在。别等到某天突然发现某条说说打不开了，才追悔莫及。

九、你的起步清单：现在就开始保护你的数字记忆

说了这么多，不如动手一试。照着下面5步走，半小时内你就能拥有一份完整的QQ空间备份：

1. 克隆项目：git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory并进入目录
2. 创建并激活虚拟环境：python -m venv myenv，再按系统激活
3. 安装依赖：pip install -r requirements.txt（网络慢可加国内镜像源）
4. 运行备份：python main.py，用手机QQ扫码登录，等待抓取完成
5. 查看成果：打开resource/result/你的QQ号/，翻一翻Excel，双击HTML，回顾你的青春

如果你在使用中遇到问题，翻一翻项目文档，或者到社区里和同样在备份记忆的人聊聊——你踩过的坑，大概率有人已经趟平了。

那些说说里的文字会褪色，但有了本地备份，回忆永远鲜活。趁着数据还在，把青春装进自己的保险箱吧。多年以后，当你双击那个HTML文件，看到十七岁那年发的那条"晚安，世界"时，你会感谢今天按下回车键的自己。

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