- Removed excessive blank lines from various markdown and Python files to improve readability and maintainability. - Ensured consistent formatting across documentation and code files, contributing to overall project clarity. - Enhanced logging mechanisms for better consistency and debugging support.
3.9 KiB
3.9 KiB
依赖安装指南
概述
本项目需要以下Python库才能正常运行。根据依赖检查结果,当前系统状态如下:
✅ 已安装的依赖
- Pillow (图片处理)
- opencv-python (计算机视觉)
- numpy (数值计算)
- paddleocr (OCR识别)
- easyocr (OCR识别,可选,已安装)
❌ 缺失的依赖
- paddlepaddle (深度学习框架,PaddleOCR的依赖)
- ttkbootstrap (GUI框架,可选,有回退机制)
快速安装
方法1:使用 requirements.txt(推荐)
# 安装所有依赖
pip install -r requirements.txt
# 如果网络较慢,使用国内镜像源
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
方法2:最小化安装
# 仅安装核心依赖
pip install -r requirements-minimal.txt
方法3:手动安装
# 核心必需依赖
pip install Pillow>=9.0.0 numpy>=1.20.0 opencv-python>=4.5.0 paddleocr>=2.7.0
# PaddleOCR依赖(如果自动安装失败)
pip install paddlepaddle>=2.5.0,<3.0.0
# 如果paddlepaddle安装失败,尝试:
# CPU版本(推荐)
pip install paddlepaddle==2.5.2 -i https://pypi.tuna.tsinghua.edu.cn/simple
# 或GPU版本(需要CUDA)
pip install paddlepaddle-gpu==2.5.2 -i https://pypi.tuna.tsinghua.edu.cn/simple
# GUI依赖(可选)
pip install ttkbootstrap>=1.10.0
依赖说明
必需依赖
| 库名 | 用途 | 版本要求 | 说明 |
|---|---|---|---|
| Pillow | 图片处理 | >=9.0.0 | Python图像处理标准库 |
| numpy | 数值计算 | >=1.20.0 | OCR和图像处理的基础 |
| opencv-python | 计算机视觉 | >=4.5.0 | 图像处理、模板匹配 |
| paddleocr | OCR识别 | >=2.7.0 | 主要OCR引擎 |
| paddlepaddle | 深度学习框架 | >=2.5.0,<3.0.0 | PaddleOCR的依赖 |
可选依赖
| 库名 | 用途 | 说明 |
|---|---|---|
| easyocr | OCR识别(备选) | 比PaddleOCR更快,但需要更多内存。如果安装,会优先使用 |
| ttkbootstrap | GUI美化 | 如果不安装,程序会自动使用原生tkinter |
依赖冲突解决
PaddleOCR 模型源检查警告
如果启动时看到模型源检查警告,这是正常的。项目已通过环境变量禁用检查:
os.environ.setdefault("DISABLE_MODEL_SOURCE_CHECK", "True")
版本兼容性
- Python: 推荐 >= 3.8,当前测试环境为 3.12.4
- paddlepaddle: 必须 < 3.0.0(PaddleOCR尚未支持3.0+)
- opencv-python: >= 4.5.0(支持所有需要的功能)
验证安装
运行以下命令检查依赖状态:
python check_dependencies.py
常见问题
Q1: paddlepaddle 安装失败
解决方案:
- 使用国内镜像源安装
- 确保Python版本 >= 3.8
- 对于Windows,可能需要安装Visual C++ Redistributable
pip install paddlepaddle==2.5.2 -i https://pypi.tuna.tsinghua.edu.cn/simple
Q2: OpenCV 导入失败
解决方案:
- 确保安装的是
opencv-python而不是opencv-contrib-python(除非需要额外功能) - 如果同时安装了两个,卸载冲突的版本
Q3: ttkbootstrap 导入失败
解决方案:
- 这是可选的,程序会自动回退到原生tkinter
- 如需安装:
pip install ttkbootstrap>=1.10.0
Q4: EasyOCR vs PaddleOCR
项目优先使用EasyOCR(如果安装),否则回退到PaddleOCR。两者都可以正常工作,选择建议:
- EasyOCR: 更快,但内存占用较大
- PaddleOCR: 更稳定,中文识别效果更好,内存占用较小
依赖树
douyin_guaji
├── Pillow (必需)
├── numpy (必需)
├── opencv-python (必需)
├── paddleocr (必需)
│ └── paddlepaddle (必需, 2.5.0 <= version < 3.0.0)
├── easyocr (可选, 优先使用)
└── ttkbootstrap (可选, GUI美化)