PyCharm Python环境中Tesseract安装失败问题求助

注意：你安装的Tesseract桌面客户端是独立可执行程序，Python无法直接调用，必须完成「Python封装库安装」和「执行路径关联」两个核心步骤，缺任意一步都会出现调用失败的问题

1. 先确认PyCharm绑定的Python解释器 #

90%的包装失败问题，都是把包装到了系统里其他Python版本上，和项目用的解释器不匹配：

• 打开PyCharm，进入 Settings > Project: <你的项目名> > Python Interpreter
• 复制页面顶部显示的解释器完整路径，虚拟环境路径一般在项目目录的venv/Scripts/python.exe（Windows）或venv/bin/python（Mac/Linux），全局Python路径看你自己的安装位置
• 后续所有Python包安装操作，必须对应这个解释器执行

2. 安装Python侧的Tesseract依赖pytesseract #

优先用PyCharm内置包管理器安装，避免路径错配：

• 在刚才的Python Interpreter设置页，点击右侧的+按钮
• 搜索pytesseract，选中后点击Install Package，等待提示安装成功即可
  如果内置安装报错，用PyCharm内置终端安装：
• 打开PyCharm底部的Terminal面板，这个面板会自动加载当前项目的解释器环境
• 直接执行安装命令：pip install pytesseract
• 执行完输入pip list | findstr pytesseract（Windows）或pip list | grep pytesseract（Mac/Linux），能返回版本号就说明安装成功

3. 关联Tesseract客户端的执行路径 #

pytesseract只是调用Tesseract程序的封装层，找不到本地安装的Tesseract可执行文件就会抛TesseractNotFoundError：

• 先找到你之前安装Tesseract客户端的路径，Windows默认安装路径是C:\Program Files\Tesseract-OCR\tesseract.exe，Mac默认是/usr/local/bin/tesseract，Linux默认是/usr/bin/tesseract
• 两种关联方式选一个就行：
  • 代码内临时指定（适合快速调试，不用改系统配置）：在导入pytesseract的代码后加一行路径配置

    import pytesseract
    # 替换成你本地的tesseract可执行文件实际路径
    pytesseract.pytesseract.tesseract_cmd = r'C:\Program Files\Tesseract-OCR\tesseract.exe'
    

  • 系统环境变量永久配置：把Tesseract的安装目录（就是tesseract.exe所在的文件夹）加到系统的Path环境变量里，保存后重启PyCharm生效，后续写代码不用额外加路径配置

4. 配置验证 #

新建测试脚本运行，能正常输出图片识别结果就说明配置完成：

import cv2
import pytesseract
# 没配系统环境变量就放开下面的注释，替换成你自己的路径
# pytesseract.pytesseract.tesseract_cmd = r'C:\Program Files\Tesseract-OCR\tesseract.exe'

# 替换成你本地的测试图片路径
img = cv2.imread("test.jpg")
# 需要识别中文的话提前把中文语言包放到Tesseract安装目录的tessdata文件夹下
text = pytesseract.image_to_string(img, lang="eng+chi_sim")
print(text)

常见问题排查 #

• 报ModuleNotFoundError: No module named 'pytesseract'：回到第一步检查解释器，你肯定把pytesseract装到别的Python版本里了
• 报TesseractNotFoundError：检查第三步的路径是不是填对了，路径要精确到tesseract.exe（Windows）或tesseract可执行文件本身，不是只写到上一级文件夹
• 识别中文报错/乱码：确认tessdata目录下有对应语言的.traineddata文件，lang参数里的语言名和文件名一致

内容的提问来源于stack exchange，提问作者kekkok