3个步骤轻松搞定QQ空间数据备份：GetQzonehistory使用指南

2026-04-23 11:26:22作者：蔡怀权

GetQzonehistory是一款专为QQ空间用户设计的智能数据备份工具，能够完整抓取并保存个人空间的所有历史说说内容，包括文字动态、图片信息和评论数据，为用户提供安全可靠的本地存储方案。无论是为了保存珍贵的网络记忆，还是出于数据安全考虑，这款工具都能满足你对QQ空间数据备份的核心需求。

一、价值定位：为什么选择GetQzonehistory？

在数字时代，我们的生活轨迹越来越多以数据形式存在，QQ空间作为许多人多年的社交记录载体，保存着大量有价值的个人记忆。GetQzonehistory通过技术手段解决了手动备份效率低、数据不完整的问题，其核心价值体现在三个方面：采用二维码扫描登录方式保护账号安全，支持多种内容类型的完整备份，以及提供Excel表格、HTML网页等多种导出格式满足不同场景需求。

二、操作流程：从准备到验证的备份之旅

2.1 准备阶段：环境搭建与依赖安装

首先获取项目代码并安装必要依赖包：

git clone https://gitcode.com/GitHub_Trending/ge/GetQzonehistory
cd GetQzonehistory
pip install -r requirements.txt

主要依赖包功能解析：

requests：处理网络请求和数据抓取的核心库
pandas：用于数据整理和Excel文件导出
qrcode：生成登录所需的二维码图片
beautifulsoup4：解析HTML内容，提取说说数据

2.2 执行阶段：启动备份流程

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

python main.py

程序启动后会显示二维码图片，使用手机QQ扫描即可完成登录授权。系统会自动统计说说总数并开始分批次抓取数据。

重要提示：如果终端无法正常显示ASCII艺术二维码，请查看temp/QR.png文件获取标准二维码图片。

2.3 验证阶段：确认备份结果

备份完成后，最终结果将保存在resource/result目录下的Excel文件中。你可以通过以下步骤验证备份是否成功：

打开Excel文件检查数据完整性
确认图片附件是否正确保存
验证评论数据是否完整

三、深度解析：工具工作原理与核心组件

3.1 核心流程：数据备份的完整链路

GetQzonehistory的数据备份流程可分为三个关键环节：

登录认证：通过二维码扫描获取用户授权
数据抓取：分页获取用户的历史说说内容
数据处理与存储：格式化数据并导出为指定格式

3.2 关键组件：功能模块解析

登录认证模块

登录模块位于util/LoginUtil.py，负责处理完整的登录流程，核心功能包括：

cookie()：管理用户登录状态，维持会话连接
bkn()：计算QQ空间API所需的认证参数，确保请求合法性

数据获取引擎

数据抓取模块路径：util/GetAllMomentsUtil.py，主要函数：

get_visible_moments_list()：分页获取所有历史说说，支持增量抓取

以下是该函数的核心代码片段，展示如何实现分页抓取：

def get_visible_moments_list(offset=0, count=20):
    """
    分页获取可见的说说列表
    
    参数:
        offset: 起始位置，用于实现分页
        count: 每页获取数量
    """
    url = "https://user.qzone.qq.com/proxy/domain/taotao.qq.com/cgi-bin/emotion_cgi_msglist_v6"
    params = {
        "uin": get_current_uin(),
        "offset": offset,
        "count": count,
        "format": "json"
    }
    # 添加认证参数
    params["bkn"] = bkn()
    response = request_get(url, params=params)
    return parse_moments_response(response.json())

数据处理中心

工具模块路径：util/ToolsUtil.py，提供数据格式化与转换功能：

format_timestamp()：将时间戳标准化为可读日期格式
replace_em_to_img()：将表情符号转换为图片引用

3.3 数据流转：信息在系统中的旅程

数据在GetQzonehistory中的流转路径为：

登录模块获取用户认证信息
数据获取引擎使用认证信息请求QQ空间API
原始数据传递给数据处理中心进行格式化
处理后的数据被写入Excel或HTML文件
最终文件保存到指定输出目录

四、拓展应用：从基础使用到高级配置

4.1 配置优化：推荐配置与高级设置

程序首次运行后会自动创建配置文件resource/config/config.ini，包含重要设置项：

推荐配置（适合大多数用户）：

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

高级配置（适合大量数据备份）：

[Common]
account = 你的QQ号码
output_file = resource/result/个人空间数据_2023.xlsx
page_size = 50
request_interval = 3
max_retry = 3
proxy = http://127.0.0.1:8080

配置说明：page_size控制单次请求数据量，建议普通用户使用20-30，数据量大的用户可适当增加但不超过50；request_interval为请求间隔时间（秒），设置过短可能导致账号临时受限。

4.2 常见问题解决：现象、原因与方案

问题一：登录后无数据返回

现象：扫码登录成功，但程序显示获取到0条说说 可能原因：Cookie失效或登录状态异常 解决方案：删除resource/user目录下的缓存文件，重新运行程序并登录

问题二：文件生成失败

现象：程序运行完成但未生成Excel文件 可能原因：目标目录无写入权限或路径不存在 解决方案：检查resource/result目录是否存在，确保当前用户有写入权限

4.3 高级使用技巧

实现增量备份

通过修改get_visible_moments_list()函数的offset参数，可以从指定位置开始抓取，实现增量备份：

# 从第100条说说开始抓取（跳过前100条）
get_visible_moments_list(offset=100)

自定义导出模板

在util/ToolsUtil.py中修改get_html_template()函数，可以定制HTML导出的样式：

def get_html_template():
    """获取HTML导出模板"""
    return """
    <!DOCTYPE html>
    <html>
    <head>
        <meta charset="UTF-8">
        <title>QQ空间备份_{date}</title>
        <style>
            /* 自定义样式 */
            .moment-item {margin-bottom: 20px; padding: 10px; border: 1px solid #eee;}
            .moment-time {color: #666; font-size: 12px;}
            /* 添加更多自定义样式 */
        </style>
    </head>
    <body>
        {content}
    </body>
    </html>
    """