3步完成QQ空间数据备份：GetQzonehistory完整使用指南

GetQzonehistory是一款专为QQ空间用户设计的本地数据备份工具，能够完整保存个人空间的历史说说内容，包括文字、图片及评论。与其他备份工具相比，它采用二维码安全登录方式，无需暴露账号密码，同时支持Excel和HTML等多种导出格式，让珍贵的网络记忆得到安全可靠的本地存储。

📋 为什么选择GetQzonehistory

• 安全登录：采用QQ二维码扫描授权，避免密码泄露风险
• 完整备份：自动抓取文字动态、图片资源和评论内容
• 多格式导出：支持Excel表格、HTML网页等多种输出格式
• 操作简单：无需复杂配置，三步即可完成全部备份流程
• 增量更新：支持从指定位置继续抓取，适合定期备份需求

🔧 环境准备与安装步骤

1. 获取项目代码

首先克隆项目仓库到本地：

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

2. 安装依赖包

项目需要以下核心依赖库支持：

• requests：处理网络请求和数据抓取
• pandas：数据整理和Excel文件生成
• qrcode：生成登录二维码图片
• beautifulsoup4：解析HTML内容提取数据

通过以下命令安装所有依赖：

pip install -r requirements.txt

🚀 开始使用：三步完成数据备份

第一步：运行主程序

在项目根目录执行主程序：

python main.py

程序启动后会生成登录二维码，你可以：

• 直接在终端查看ASCII艺术二维码
• 或打开temp/QR.png文件获取标准二维码图片

第二步：手机QQ扫码授权

使用手机QQ扫描显示的二维码，确认登录授权。成功登录后，程序会自动开始：

• 验证登录状态
• 获取用户信息
• 统计历史说说总数

第三步：等待备份完成

程序将分批次抓取历史数据，进度会实时显示在终端。完成后，数据文件会保存到resource/result目录，默认文件名为个人空间数据.xlsx。

📊 功能模块解析

登录认证模块

路径：util/LoginUtil.py

负责安全登录流程，核心功能包括：

• 生成登录二维码
• 管理用户Cookie状态
• 计算认证参数BKN值
• 维持会话有效性

数据获取模块

路径：util/GetAllMomentsUtil.py

主要负责数据抓取工作，核心函数：

• get_visible_moments_list()：分页获取历史说说
• 处理分页逻辑和数据拼接
• 异常处理和重试机制

数据处理模块

路径：util/ToolsUtil.py

提供数据转换和格式化功能：

• format_timestamp()：时间戳转换为标准日期格式
• replace_em_to_img()：将表情代码转换为图片引用
• 数据清洗和结构化处理

⚙️ 个性化配置

基础配置文件

首次运行后，程序会在resource/config/目录下自动创建config.ini文件，包含关键配置项：

[Common]
account = 你的QQ号码
output_file = resource/result/个人空间数据.xlsx
page_size = 20

你可以根据需要修改：

• output_file：自定义输出文件路径和名称
• page_size：调整单次请求的数据量（默认20条）

性能优化建议

对于数据量较大的用户，可通过以下方式优化：

• 适当增大page_size值减少请求次数
• 避免短时间内频繁运行程序
• 确保网络连接稳定

🔍 常见问题解决

二维码无法显示

问题：终端不支持ASCII二维码显示 解决：查看temp目录下自动生成的QR.png图片文件

登录后无数据返回

可能原因：

• Cookie缓存过期
• 网络连接异常
• 账号权限限制

解决方法：删除resource/user目录下的缓存文件，重新运行程序登录

导出文件生成失败

排查方向：

1. 检查目标路径是否存在
2. 确认有写入权限
3. 关闭可能占用文件的程序

💡 高级使用技巧

实现增量备份

修改get_visible_moments_list()函数的offset参数，设置起始位置，实现从指定位置开始抓取，适合定期备份更新。

自定义导出格式

编辑util/ToolsUtil.py中的get_html_template()函数，可以定制HTML导出的样式和布局，打造个性化的数据展示页面。

批量下载图片

默认配置下，程序会自动保存说说中的图片。如需单独下载图片资源，可修改ToolsUtil.py中的图片处理逻辑，指定单独的保存路径。

📌 使用注意事项

• 操作频率：建议单次登录完成所有备份操作，避免频繁登录
• 数据安全：resource/user目录下的Cookie文件包含登录信息，需妥善保管
• 定期备份：建议每月执行一次备份，确保数据及时更新
• 隐私保护：导出的备份文件包含个人信息，请注意存储安全

通过以上步骤，你已经掌握了GetQzonehistory的完整使用方法。这款工具将帮助你安全、完整地保存QQ空间的珍贵回忆，让数字记忆不再随着时间流逝而丢失。