GetQzonehistory全平台使用指南：从安装到高级应用

功能解析：为什么选择GetQzonehistory？

想备份QQ空间多年的说说记录却找不到合适工具？GetQzonehistory作为一款专注于QQ空间数据导出的开源工具，能帮你完整保存说说、转发、留言等历史数据。它支持多平台运行，提供Excel格式导出，还能在网络中断后自动恢复进度，特别适合需要长期保存个人数字记忆的用户。

环境准备：如何快速配置运行环境？

3分钟环境检测

开始前请确认系统已安装以下组件：

• Python 3.7+ - 推荐3.9版本以获得最佳兼容性
• Git - 用于获取项目代码
• 稳定网络连接 - 用于依赖下载和QQ空间访问

[!TIP] 不确定Python版本？在终端输入python --version（Windows）或python3 --version（macOS/Linux）即可查看

项目获取与依赖安装

1. 克隆项目代码库：

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

2. 创建独立虚拟环境避免依赖冲突：

# Windows系统
python -m venv myenv
.\myenv\Scripts\activate

# macOS/Linux系统
python3 -m venv myenv
source myenv/bin/activate

3. 使用国内镜像加速依赖安装：

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

平台适配：不同系统如何优化配置？

平台特性对比表

特性	Windows	macOS	Linux
虚拟环境激活	.\myenv\Scripts\activate	source myenv/bin/activate	source myenv/bin/activate
Python命令	python	python3	python3
图形支持	原生支持	需XQuartz	需桌面环境
依赖安装难度	★☆☆☆☆	★★☆☆☆	★★★☆☆
自动更新	需手动	需手动	可配置crontab

Windows平台配置要点

[!TIP] Windows用户请确保勾选"Add Python to PATH"选项安装Python

# 完整启动流程
cd GetQzonehistory
python -m venv myenv
.\myenv\Scripts\activate
pip install -r requirements.txt
python main.py

macOS平台配置要点

# 安装Xcode命令行工具（如未安装）
xcode-select --install

# 启动程序
cd GetQzonehistory
python3 -m venv myenv
source myenv/bin/activate
pip3 install -r requirements.txt
python3 main.py

Linux平台配置要点

# Ubuntu/Debian系统预装依赖
sudo apt update && sudo apt install -y python3 python3-venv python3-pip git

# CentOS/RHEL系统预装依赖
sudo dnf install -y python3 python3-venv python3-pip git

# 启动程序
cd GetQzonehistory
python3 -m venv myenv
source myenv/bin/activate
pip3 install -r requirements.txt
python3 main.py

进阶使用：如何充分发挥工具潜力？

数据导出高级设置

程序默认将数据保存到「resource/result」目录，支持以下导出格式：

• QQ号_说说列表.xlsx - 原始说说内容
• QQ号_全部列表.xlsx - 包含转发和评论的综合数据
• QQ号_媒体资源 - 自动下载的图片和视频文件

[!TIP] 可通过修改「util/ConfigUtil.py」中的EXPORT_FORMAT参数切换导出格式，支持CSV和JSON格式

常见错误速查表

错误现象	可能原因	解决方案
二维码无法显示	缺少图形界面支持	安装图形化环境或使用--headless参数
依赖安装失败	网络问题或Python版本过低	切换国内镜像或升级Python到3.7+
登录后无响应	Cookie过期或账号安全限制	清除缓存后重新登录或使用手机QQ扫码
数据导出中断	网络不稳定	程序会自动保存进度，重新运行即可继续

性能优化技巧

1. 批量获取设置：修改BATCH_SIZE参数（默认20条/批）可调整单次请求数量
2. 缓存清理：定期删除「cache」目录可释放存储空间
3. 代理配置：在「config.ini」中设置HTTP代理可解决网络访问限制

通过以上配置，你已经掌握了GetQzonehistory的全部使用技巧。这个工具不仅能帮你备份珍贵的数字记忆，还能通过数据导出功能进行个人社交数据分析。记得定期备份数据，让你的QQ空间回忆永远不会丢失。