Files
douyi_guaji_main/DEPENDENCY_GUIDE.md
T
Your Name 29f7b19916 fix: Clean up code by removing unnecessary blank lines
- Removed excessive blank lines from various markdown and Python files to enhance readability and maintainability.
- Ensured consistent formatting across documentation and code files, improving overall project clarity.
2025-12-25 16:55:44 +08:00

3.8 KiB
Raw Blame History

依赖安装指南

概述

本项目需要以下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 安装失败

解决方案:

  1. 使用国内镜像源安装
  2. 确保Python版本 >= 3.8
  3. 对于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美化)