QQ空间数据备份工具全平台部署指南：轻松导出历史记录

想要完整保存QQ空间的珍贵回忆吗？GetQzonehistory是一款专为QQ空间历史记录导出设计的开源工具，支持快速备份说说、转发、留言等内容。本指南将带你3分钟上手全平台安装流程，让你的数字记忆永不丢失！

📋 系统兼容性检测清单

在开始安装前，请确保你的设备满足以下条件：

检查项	最低要求	推荐配置
操作系统	Windows 7+/macOS 10.13+/Linux kernel 4.15+	Windows 10+/macOS 12+/Ubuntu 20.04+
Python版本	3.7.x	3.9.x-3.11.x
网络环境	稳定互联网连接	5Mbps以上带宽
存储空间	100MB空闲空间	500MB以上（含缓存）
额外依赖	Git	Git 2.30+

⚠️ 注意哦～Linux用户需要预先安装python3-venv包，Debian/Ubuntu系统可通过sudo apt install python3-venv命令安装

🚀 分阶段安装指南

准备阶段：获取项目代码

首先我们需要把工具源码下载到本地：

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

看到命令行前面出现(myenv)就说明环境激活成功啦！接下来安装依赖包：

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

验证测试：启动程序

一切准备就绪，让我们启动程序看看效果：

python main.py

首次运行会显示登录二维码，使用手机QQ扫码授权即可开始数据备份。搞定了！

💻 跨平台操作对比

操作步骤	Windows系统	macOS/Linux系统
虚拟环境激活	.\myenv\Scripts\activate	source myenv/bin/activate
Python命令	python	python3
Pip命令	pip	pip3
二维码显示	自动弹出图片窗口	终端内直接显示
数据存储路径	用户目录\AppData\Local\GetQzonehistory	~/.local/share/GetQzonehistory

📌 核心组件速览

这款工具由以下关键模块组成：

• 主程序入口：负责协调各模块工作流程，提供用户交互界面
• 登录模块：通过二维码方式安全获取QQ空间访问权限
• 网络请求模块：处理与QQ空间服务器的通信，实现数据抓取
• 数据解析模块：从原始网页中提取说说、转发、留言等关键信息
• 数据存储模块：将获取的内容整理并导出为Excel格式

📊 数据导出结果

程序运行完成后，会在项目的resource/result目录下生成多种Excel文件：

• QQ号_说说列表.xlsx：包含所有原创内容、发布时间、点赞数等信息
• QQ号_转发列表.xlsx：记录转发内容及原始链接
• QQ号_留言列表.xlsx：完整备份留言板互动记录
• QQ号_全部列表.xlsx：整合所有数据的汇总表格

⚠️ 避坑指南：常见问题解决

问题1：依赖安装速度慢或失败

• 解决方案：确保使用了国内镜像源，命令中的阿里云镜像已为你配置好

问题2：二维码无法显示

• 解决方案：Linux无图形界面用户可尝试python main.py --cli使用命令行模式

问题3：数据获取不完整

• 解决方案：不要频繁中断程序，大型账号建议分多次获取

🔒 隐私保护指南

使用本工具时，请务必注意：

1. 数据安全：所有数据处理均在本地完成，不会上传至第三方服务器
2. 存储建议：导出的Excel文件建议加密存储或定期备份到安全位置
3. 使用规范：仅用于个人数据备份，未经允许不得获取他人空间内容
4. 账号安全：扫码登录后建议在完成备份后及时退出授权

通过以上步骤，你已经成功部署了QQ空间数据备份工具。现在就开始保存那些珍贵的数字回忆吧！如有任何问题，欢迎在项目仓库提交issue获取帮助。