安装指南
本指南将帮助您快速安装和配置美团店铺数据处理工具。
📋 环境要求
系统要求
- 操作系统: Windows 10/11 (推荐)、Linux、macOS
- Python版本: Python 3.7 或更高版本
- 内存要求: 至少 4GB RAM
- 磁盘空间: 至少 500MB 可用空间
- 网络连接: 用于下载图片和依赖包
推荐配置
- 操作系统: Windows 11
- Python版本: Python 3.9+
- 内存: 8GB RAM 或更多
- 磁盘空间: 2GB 可用空间
- 显示器: 1920x1080 或更高分辨率
🚀 安装方式
方式一：下载安装包 (推荐)
适合不熟悉Python环境的用户。
下载exe文件
下载地址: dist/美团店铺数据处理工具.exe 文件大小: 约50-200MB1
2运行程序
- 双击
美团店铺数据处理工具.exe - 首次启动可能需要5-15秒
- 如被杀毒软件拦截，请添加到白名单
- 双击
验证安装
- 程序界面正常显示
- 窗口标题显示"美团店铺数据处理工具"
- 所有功能按钮可正常点击
优势
- 无需安装Python环境
- 无需配置依赖库
- 可在任何Windows电脑运行
- 包含自定义图标
方式二：Python源码安装
适合开发者和高级用户。
1. 安装Python环境
Windows用户:
bash
# 下载Python 3.9+
https://www.python.org/downloads/
# 验证安装
python --version
pip --version1
2
3
4
5
6
2
3
4
5
6
Linux用户:
bash
# Ubuntu/Debian
sudo apt update
sudo apt install python3 python3-pip
# CentOS/RHEL
sudo yum install python3 python3-pip1
2
3
4
5
6
2
3
4
5
6
macOS用户:
bash
# 使用Homebrew
brew install python3
# 或下载官方安装包
https://www.python.org/downloads/mac-osx/1
2
3
4
5
2
3
4
5
2. 克隆项目代码
bash
# 克隆仓库
git clone https://github.com/your-org/meituan-data-processor.git
cd meituan-data-processor
# 或下载ZIP包并解压1
2
3
4
5
2
3
4
5
3. 安装依赖
自动安装 (推荐):
bash
# 安装所有依赖
pip install -r requirements.txt1
2
2
手动安装:
bash
# 核心依赖
pip install PyQt5>=5.15.0
pip install PyQt-Fluent-Widgets>=1.1.0
pip install pandas>=1.5.0
pip install requests>=2.28.0
pip install openpyxl>=3.0.0
pip install Pillow>=9.0.0
pip install watchdog>=2.1.01
2
3
4
5
6
7
8
2
3
4
5
6
7
8
使用国内镜像 (加速安装):
bash
# 清华大学镜像
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/
# 阿里云镜像
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/1
2
3
4
5
2
3
4
5
4. 验证安装
bash
# 测试导入
python -c "import PyQt5; import qfluentwidgets; import pandas; print('所有依赖安装成功!')"
# 启动程序
python gui_fluent.py1
2
3
4
5
2
3
4
5
🔧 依赖说明
核心依赖库
| 库名 | 版本要求 | 用途 | 重要性 |
|---|---|---|---|
| PyQt5 | >=5.15.0 | GUI框架基础 | ⭐⭐⭐⭐⭐ |
| PyQt-Fluent-Widgets | >=1.1.0 | 现代化UI组件库 | ⭐⭐⭐⭐⭐ |
| pandas | >=1.5.0 | 数据处理和分析 | ⭐⭐⭐⭐ |
| openpyxl | >=3.0.0 | Excel文件操作 | ⭐⭐⭐⭐ |
| requests | >=2.28.0 | 网络请求和图片下载 | ⭐⭐⭐⭐ |
| Pillow | >=9.0.0 | 图像处理和格式转换 | ⭐⭐⭐⭐ |
| watchdog | >=2.1.0 | 文件系统监控 | ⭐⭐⭐ |
可选依赖
| 库名 | 用途 | 安装命令 |
|---|---|---|
| PyInstaller | 打包为exe文件 | pip install PyInstaller |
| pytest | 运行测试 | pip install pytest |
| black | 代码格式化 | pip install black |
🚀 启动方式
GUI启动 (推荐)
方式1: 批处理文件 (最简单)
bash
# Windows用户
双击 run.bat
# 或命令行运行
run.bat1
2
3
4
5
2
3
4
5
方式2: Python启动
bash
# 启动Fluent Design界面
python gui_fluent.py
# 使用GUI启动器
python run_gui.py1
2
3
4
5
2
3
4
5
方式3: 多版本界面
bash
# 基础GUI界面
python gui_main.py
# 增强版GUI界面
python gui_enhanced.py1
2
3
4
5
2
3
4
5
命令行启动
bash
# 启动命令行菜单
python launcher.py
# 直接处理文件
python malatang_processor.py
# 启动文件监控
python malatang_processor.py --monitor1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
⚠️ 常见问题
安装问题
Q: 依赖安装失败
bash
# 解决方案1: 升级pip
python -m pip install --upgrade pip
# 解决方案2: 使用国内镜像
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/
# 解决方案3: 清理缓存
pip cache purge1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
Q: QFluentWidgets安装失败
bash
# 确保Python版本3.7+
python --version
# 手动安装
pip install PyQt-Fluent-Widgets
# 如果仍然失败，尝试
pip install PyQt-Fluent-Widgets --no-cache-dir1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
Q: PyQt5安装失败
bash
# Windows用户
pip install PyQt5 -i https://pypi.douban.com/simple/
# Linux用户可能需要额外包
sudo apt-get install python3-pyqt5
# macOS用户
brew install pyqt51
2
3
4
5
6
7
8
2
3
4
5
6
7
8
运行问题
Q: GUI界面无法启动
- 确保已安装PyQt5和QFluentWidgets
- 尝试运行基础GUI:
python gui_main.py - 检查Python版本是否为3.7+
- 查看错误日志了解具体问题
Q: 程序启动缓慢
- 首次启动需要加载组件，属于正常现象
- 后续启动会更快
- 可以考虑使用SSD硬盘
Q: 杀毒软件误报
- 将程序添加到杀毒软件白名单
- 或临时关闭实时保护进行安装
🔄 更新升级
源码版本更新
bash
# 拉取最新代码
git pull origin main
# 更新依赖
pip install -r requirements.txt --upgrade
# 重新启动程序
python gui_fluent.py1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
exe版本更新
- 下载最新的exe文件
- 替换旧版本文件
- 重新启动程序
📦 打包部署
如果您需要自己打包exe文件：
bash
# 安装打包依赖
python install_build_deps.py
# 执行打包
python simple_build.py
# 验证结果
python verify_icon.py1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
生成的文件位于 dist/美团店铺数据处理工具.exe
安装成功
如果您已成功安装，请继续阅读 快速开始 了解如何使用工具。
注意事项
- 首次运行可能需要较长时间加载
- 确保网络连接正常以便下载图片
- 建议在SSD硬盘上运行以获得更好性能