北陌大叔1. Windows下源码安装PaddleOCR 3.4.0全攻略
最近在Windows平台上折腾PaddleOCR 3.4.0的源码安装，发现这个版本相比之前的2.x系列改动不小。官方文档虽然提供了安装指引，但实际操作中还是会遇到各种坑。经过几天的踩坑和验证，我把完整的安装过程和注意事项整理出来，希望能帮到同样需要从源码构建PaddleOCR环境的开发者。
PaddleOCR 3.4.0最大的变化是采用了模块化设计，核心OCR功能现在通过PaddleX包提供，同时支持按需安装文档解析、信息提取等扩展功能。这种设计虽然提高了灵活性，但也增加了安装的复杂度。下面就从环境准备到最终验证，一步步带你完成安装。
1.1 Python环境准备
PaddleOCR 3.4.0对Python版本有明确要求，官方支持Python 3.8到3.12。我强烈建议使用Anaconda创建独立的虚拟环境，避免与其他项目的依赖冲突。以下是具体步骤：
bash复制# 创建名为paddleocr340_env，Python版本为3.10的环境
conda create -n paddleocr340_env python=3.10
# 激活环境
conda activate paddleocr340_env
选择Python 3.10是因为它在兼容性和稳定性上表现最好。如果使用其他版本，可能会遇到某些依赖包的兼容性问题。激活环境后，建议先升级pip到最新版本：
bash复制python -m pip install --upgrade pip
1.2 PaddlePaddle核心引擎安装
PaddleOCR依赖于PaddlePaddle深度学习框架，3.4.0版本要求PaddlePaddle必须≥3.0.0。根据你的硬件配置，可以选择CPU或GPU版本：
CPU版本安装（兼容性最好）
bash复制pip install paddlepaddle -i https://mirror.baidu.com/pypi/simple
GPU版本安装（需要NVIDIA显卡）
bash复制# 以CUDA 11.8为例
pip install paddlepaddle-gpu==3.4.0 -f https://