三步搞定GetQzonehistory全平台部署：从安装到数据导出完整指南

GetQzonehistory是一款能够完整获取QQ空间发布的历史说说的开源工具，支持导出说说、转发、留言等数据并保存为Excel格式，适用于个人数据备份和历史记录整理。本文将通过"准备-安装-配置-使用"四个阶段，带你在Windows、macOS和Linux系统上快速部署这款实用工具。

如何准备GetQzonehistory的运行环境

在开始部署前，请确保你的系统满足以下条件：

• Python 3.7+（编程语言环境，用于运行Python脚本）
• Git（版本控制工具，用于获取项目代码）
• 网络连接（用于下载依赖包和访问QQ空间API）

各平台环境准备对比

平台	Python安装命令	Git安装命令	虚拟环境激活命令
Windows	官网下载	Git官网	.\myenv\Scripts\activate
macOS	brew install python3	brew install git	source myenv/bin/activate
Linux	sudo apt install python3 python3-pip	sudo apt install git	source myenv/bin/activate

📌 小贴士：Windows用户安装Python时需勾选"Add Python to PATH"选项，否则需手动配置环境变量。

如何安装GetQzonehistory项目

🔧 步骤1/3：获取项目代码

打开终端（命令提示符/终端应用），执行以下命令克隆项目：

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

🔧 步骤2/3：创建虚拟环境

虚拟环境（用于隔离项目依赖，避免不同项目间包冲突）的创建方法：

# Windows系统
python -m venv myenv

# macOS/Linux系统
python3 -m venv myenv

🔧 步骤3/3：安装依赖包

激活虚拟环境后，使用国内镜像源安装依赖以提高速度：

# Windows系统
.\myenv\Scripts\activate
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt

# macOS/Linux系统
source myenv/bin/activate
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt

⚠️ 注意事项：如果出现"pip: command not found"错误，尝试使用pip3命令替代pip。

各平台配置与启动指南

Windows系统配置指南

# 激活虚拟环境
.\myenv\Scripts\activate

# 运行主程序
python main.py

macOS系统配置指南

# 激活虚拟环境
source myenv/bin/activate

# 运行主程序
python3 main.py

Linux系统配置指南

# 激活虚拟环境
source myenv/bin/activate

# 运行主程序
python3 main.py

📌 关键提示：首次运行会生成配置文件，建议保持默认设置，如需修改可编辑util/ConfigUtil.py文件。

功能模块与使用方法

GetQzonehistory主要由以下功能模块组成：

• 登录模块（LoginUtil.py）：处理QQ空间登录验证，支持二维码扫码登录
• 请求模块（RequestUtil.py）：封装网络请求，处理Cookie和请求头
• 数据获取模块（GetAllMomentsUtil.py）：核心功能，负责抓取说说、转发等数据
• 工具模块（ToolsUtil.py）：提供数据处理和格式转换功能
• 主程序（main.py）：协调各模块，提供用户交互界面

数据导出格式

程序运行成功后，将在项目目录下生成以下文件：

• 📄 QQ号_说说列表.xlsx - 包含所有原创说说内容
• 📄 QQ号_转发列表.xlsx - 记录转发内容及原作者信息
• 📄 QQ号_留言列表.xlsx - 留言板互动记录
• 📄 QQ号_好友列表.xlsx - 好友基本信息
• 📄 QQ号_全部列表.xlsx - 所有数据的汇总表格

常见问题与故障排除

场景1：二维码无法显示

问题描述：运行程序后未弹出二维码窗口，无法登录
解决方案：

1. 检查是否安装了图形界面依赖：pip install pillow qrcode
2. 尝试手动保存二维码图片：程序会在当前目录生成qrcode.png文件

场景2：数据导出失败

问题描述：程序运行完成但未生成Excel文件
解决方案：

1. 检查是否有写入权限：ls -ld .（Linux/macOS）
2. 确认已安装Excel处理依赖：pip install openpyxl pandas

场景3：网络连接错误

问题描述：提示"网络请求失败"或"连接超时"
解决方案：

1. 检查网络代理设置，尝试关闭VPN
2. 执行ping qzone.qq.com测试网络连通性
3. 修改请求间隔：编辑util/ConfigUtil.py中的REQUEST_DELAY参数

使用技巧与最佳实践

1. 增量备份：程序支持断点续传，中断后重新运行会从上次停止处继续
2. 数据筛选：在fetch_all_message.py中修改start_date和end_date可指定时间范围
3. 性能优化：对于大量数据，建议分批次获取，每次间隔5-10分钟

GetQzonehistory作为一款轻量级开源工具，为QQ空间用户提供了便捷的数据备份方案。通过本文介绍的三步部署法，你可以在任何主流操作系统上快速搭建属于自己的历史记录导出工具。记得定期备份数据，让珍贵的网络记忆得以永久保存。