配置好的ppocrlabel如图，我还真的是经历了一下午的折腾，本来一个几分钟就可以搞定的东西，就是因为听了AI的指导，谨慎AI（血的教训）
这是一篇从无数次失败中总结出的真实教程，没有虚构的错误，没有多余的废话。只要你的环境是 Windows + PyCharm，照着做，20 分钟内就能跑起 PPOCRLabel。
一、真正的坑在哪里？
经过几个小时的排查，真正阻碍安装的只有三个问题：
- PyQt5 安装卡住 ：用命令行
pip install pyqt5在国内网络环境下经常卡在最后一步，进度条不动。 ModuleNotFoundError: No module named 'ppstructure'：PaddleOCR 最新版（3.x）更改了 API，和 PPOCRLabel 不兼容。- Python 版本过高：PyQt5 官方对 Python 3.10+ 的支持并不完善，很多兼容性问题。
- 如果pyqt5出现了d3dcompiler_47.dll权限问题，那么关闭你的360杀毒软件一般可以解决。
二、解决方案（三步走）
第一步：锁定 Python 3.9
不需要卸载你电脑上已有的任何 Python 版本，只需要在 PyCharm 项目里指定 3.9。
- 如果还没有 Python 3.9，去 python.org 下载安装包。安装时 不要勾选 "Add to PATH"（避免干扰系统默认 Python）。
- 记住安装路径，例如
d:\Python39\python.exe。
第二步：用 PyCharm 包管理器安装 PyQt5（禁止用命令行）
这是最关键的一步，一定不要打开 Terminal 敲
pip install pyqt5。
- 在 PyCharm 中新建项目，或打开已有项目。
- 进入
File→Settings→Python →Interpreter。 - 点击右侧的
+号（绿色加号）。 - 在搜索框输入
pyqt5，等待列表加载。 - 选中
pyqt5主包 ，然后勾选右下角的Specify version，从下拉列表中选择5.15.11。 - 点击
Install Package，等待进度条走完。
✅ 这种方式安装 PyQt5 不会卡住、不会报网络错误、不需要换镜像源、不需要管理员权限。成功率 100%。
第三步：安装 PPOCRLabel 并降级 PaddleOCR
-
安装 PPOCRLabel ：依然在
Python Interpreter界面，点击+号，搜索PPOCRLabel，直接安装（不指定版本，默认最新即可）。 -
如果使用命令行来安装多数安装的是3.5版本的，如果安装上了就会在执行ppocrlabel.py的时候出错，这个时候你没有选择，卸载它。
d:\ppocrlabel> pip uninstall paddleocr
Found existing installation: paddleocr 3.5.0
Uninstalling paddleocr-3.5.0:
PPOCRLabel 的下载地址（这个是我从github上克隆下来的，github下载实在太慢了）
下载地址 -
降级 PaddleOCR （否则会报
No module named 'ppstructure'）：- 在包列表中找到
paddleocr。 - 点击它右侧的下拉箭头（或双击它），在弹出的版本列表中，选择
3.0。 - 点击
Install Package，等待完成。
-也可以是在卸载完成后用命令行来安装，指定版本安装：pip install paddleocr==3.0
- 在包列表中找到
-
其他依赖 ：
PPOCRLabel会自动拉取paddlepaddle、openpyxl等，不需要额外安装。如果自动标注需要导出 Excel，确保openpyxl已安装（同样在包管理器里装一下）。
三、启动与使用
在ppocrlabel的目录中找到ppocrlabel.py，直接在pycharm中点击运行即可看到运行的画面，就是我博文开头的画面。首次运行会下载默认的模型依赖实现自动标注。
当然，你也可以在cmd模式下舍易求难。
-
windows中的运行，输入cmd进入Terminal （确保虚拟环境已激活，前缀显示
(.venv)）。 -
执行命令：
bashPPOCRLabel --lang ch如果提示找不到命令，则用：
bashpython -m PPOCRLabel --lang ch -
成功启动后，会看到 PPOCRLabel 图形界面。
自动标注不起作用的处理
- 第一次点击"自动标注"时，程序会从网络下载内置模型到
C:\Users\你的用户名\.paddlex。如果网络慢导致失败，删除该文件夹，然后重新启动 PPOCRLabel，它会重试。 - 确保图片所在的文件夹路径以及图片文件名不包含中文（否则 OpenCV 无法读取）。
- 如果仍然没有识别结果，检查 PyCharm 控制台是否有类似
ConnectionError的输出，那说明网络问题，可以手动下载模型文件放到对应目录（此处不展开，有需要可自行搜索）。
四、常见问题（真实发生的）
| 现象 | 原因 | 解决 |
|---|---|---|
ModuleNotFoundError: No module named 'ppstructure' |
PaddleOCR 版本太高（3.x） | 按上文降级到 2.7.1 |
PPOCRLabel : 无法将"PPOCRLabel"项识别为 cmdlet |
虚拟环境中没有该可执行文件 | 用 python -m PPOCRLabel --lang ch |
| 自动标注按钮点击后没有反应 | 模型下载失败或图片路径有中文 | 删除 ~/.paddlex 并重试，改英文路径 |
| 安装 PyQt5 进度条不动 | 使用了命令行 pip 且未换源 |
改用 PyCharm 包管理器安装 |
五、总结
- 不用 conda，不用手动创建虚拟环境，不用管理员运行，不用担心什么 dll 文件。
- 唯一需要你做的：Python 3.9 + PyCharm 包管理器装 PyQt5 + 降级 paddleocr。
- 按这三步，10 分钟就能用上 PPOCRLabel 开始标注。