配置好的ppocrlabel如图，我还真的是经历了一下午的折腾，本来一个几分钟就可以搞定的东西，就是因为听了AI的指导，谨慎AI（血的教训）

这是一篇从无数次失败中总结出的真实教程，没有虚构的错误，没有多余的废话。只要你的环境是 Windows + PyCharm，照着做，20 分钟内就能跑起 PPOCRLabel。

一、真正的坑在哪里？

经过几个小时的排查，真正阻碍安装的只有三个问题：

1. PyQt5 安装卡住：用命令行 pip install pyqt5 在国内网络环境下经常卡在最后一步，进度条不动。
2. ModuleNotFoundError: No module named 'ppstructure'：PaddleOCR 最新版（3.x）更改了 API，和 PPOCRLabel 不兼容。
3. Python 版本过高：PyQt5 官方对 Python 3.10+ 的支持并不完善，很多兼容性问题。

而网上流传的 d3dcompiler_47.dll 权限错误、管理员运行、conda 环境等等，大多是与你无关。你根本不会遇到那些问题。

二、解决方案（三步走）

第一步：锁定 Python 3.9

不需要卸载你电脑上已有的任何 Python 版本，只需要在 PyCharm 项目里指定 3.9。

1. 如果还没有 Python 3.9，去 python.org 下载安装包。安装时 不要勾选 “Add to PATH”（避免干扰系统默认 Python）。
2. 记住安装路径，例如 d:\Python39\python.exe。

第二步：用 PyCharm 包管理器安装 PyQt5（禁止用命令行）

这是最关键的一步，一定不要打开 Terminal 敲 pip install pyqt5。

1. 在 PyCharm 中新建项目，或打开已有项目。
2. 进入 File → Settings →Python → Interpreter。
3. 点击右侧的 + 号（绿色加号）。
4. 在搜索框输入 pyqt5，等待列表加载。
5. 选中 pyqt5 主包，然后勾选右下角的 Specify version，从下拉列表中选择 5.15.11。
6. 点击 Install Package，等待进度条走完。

✅ 这种方式安装 PyQt5 不会卡住、不会报网络错误、不需要换镜像源、不需要管理员权限。成功率 100%。

第三步：安装 PPOCRLabel 并降级 PaddleOCR

1. 安装 PPOCRLabel：依然在 Python Interpreter 界面，点击 + 号，搜索 PPOCRLabel，直接安装（不指定版本，默认最新即可）。

2. 如果使用命令行来安装多数安装的是3.5版本的，如果安装上了就会在执行ppocrlabel.py的时候出错，这个时候你没有选择，卸载它。
   d:\ppocrlabel> pip uninstall paddleocr
   Found existing installation: paddleocr 3.5.0
   Uninstalling paddleocr-3.5.0:
   PPOCRLabel 的下载地址（这个是我从github上克隆下来的，github下载实在太慢了）
   下载地址

3. 降级 PaddleOCR（否则会报 No module named 'ppstructure'）：

   • 在包列表中找到 paddleocr。
   • 点击它右侧的下拉箭头（或双击它），在弹出的版本列表中，选择 3.0。
   • 点击 Install Package，等待完成。
     -也可以是在卸载完成后用命令行来安装，指定版本安装：pip install paddleocr==3.0

4. 其他依赖：PPOCRLabel 会自动拉取 paddlepaddle、openpyxl 等，不需要额外安装。如果自动标注需要导出 Excel，确保 openpyxl 已安装（同样在包管理器里装一下）。

三、启动与使用

在ppocrlabel的目录中找到ppocrlabel.py，直接在pycharm中点击运行即可看到运行的画面，就是我博文开头的画面。首次运行会下载默认的模型依赖实现自动标注。
当然，你也可以在cmd模式下舍易求难。

1. windows中的运行，输入cmd进入Terminal（确保虚拟环境已激活，前缀显示 (.venv)）。
2. 执行命令：

   PPOCRLabel --lang ch
   

   如果提示找不到命令，则用：

   python -m PPOCRLabel --lang ch
   

3. 成功启动后，会看到 PPOCRLabel 图形界面。

自动标注不起作用的处理

• 第一次点击“自动标注”时，程序会从网络下载内置模型到 C:\Users\你的用户名\.paddlex。如果网络慢导致失败，删除该文件夹，然后重新启动 PPOCRLabel，它会重试。
• 确保图片所在的文件夹路径以及图片文件名不包含中文（否则 OpenCV 无法读取）。
• 如果仍然没有识别结果，检查 PyCharm 控制台是否有类似 ConnectionError 的输出，那说明网络问题，可以手动下载模型文件放到对应目录（此处不展开，有需要可自行搜索）。

四、常见问题（真实发生的）

五、总结

• 不用 conda，不用手动创建虚拟环境，不用管理员运行，不用担心什么 dll 文件。
• 唯一需要你做的：Python 3.9 + PyCharm 包管理器装 PyQt5 + 降级 paddleocr。
• 按这三步，10 分钟就能用上 PPOCRLabel 开始标注。