Pytesseract在VSCode可用但PyCharm中无法运行的问题

问题 #

Ubuntu 22.04系统，已在conda Python 3.11环境中安装Tesseract 5.2.0。该环境下，VSCode中可正常执行import pytesseract和pytesseract.get_languages()代码，但在PyCharm中运行相同代码时抛出TesseractNotFoundError，提示“tesseract is not installed or it's not in your PATH”。

Tesseract版本信息 #

tesseract --version
tesseract 5.2.0
 leptonica-1.82.0
  libgif 5.2.1 : libjpeg 9e : libpng 1.6.39 : libtiff 4.5.1 : zlib 1.2.13 : libwebp 1.2.4 : libopenjp2 2.4.0
 Found AVX2
 Found AVX
 Found FMA
 Found SSE4.1
 Found OpenMP 201511
 Found libarchive 3.6.2 zlib/1.2.13 liblzma/5.4.2 bz2lib/1.0.8 liblz4/1.9.4 libzstd/1.5.2

报错信息 #

TesseractNotFoundError                    Traceback (most recent call last)
Cell In[6], line 1
----> 1 pytesseract.get_languages()

File ~/anaconda3/envs/pdfextractor/lib/python3.11/site-packages/pytesseract/pytesseract.py:146, in run_once.<locals>.wrapper(*args, **kwargs)
    143 @wraps(func)
    144 def wrapper(*args, **kwargs):
    145     if wrapper._result is wrapper:
---> 146         wrapper._result = func(*args, **kwargs)
    147     return wrapper._result

File ~/anaconda3/envs/pdfextractor/lib/python3.11/site-packages/pytesseract/pytesseract.py:370, in get_languages(config)
    368 # tesseract 3.x
    369 if result.returncode not in (0, 1):
---> 370     raise TesseractNotFoundError()
    372 languages = []
    373 if result.stdout:

TesseractNotFoundError: tesseract is not installed or it's not in your PATH. See README file for more information.

原因及解决方法 #

核心原因 #

VSCode默认继承终端的完整环境变量PATH，而PyCharm启动时可能未加载系统或conda环境的完整PATH，导致无法定位tesseract可执行文件。

解决办法 #

1. 代码中直接指定Tesseract路径
   先通过终端执行which tesseract获取可执行文件路径，然后在代码中手动配置：

import pytesseract
# 替换为你的实际路径
pytesseract.pytesseract.tesseract_cmd = r'/home/your_username/anaconda3/envs/pdfextractor/bin/tesseract'
print(pytesseract.get_languages())

2. 配置PyCharm运行环境的PATH

• 打开PyCharm，进入Run > Edit Configurations
• 选中对应运行配置，点击Environment variables的编辑按钮
• 添加或修改PATH变量，将tesseract所在目录（如conda环境的bin目录）加入，多路径用冒号:分隔
• 保存配置后重新运行代码

3. 从终端启动PyCharm继承环境变量

• 关闭PyCharm，在终端激活目标conda环境：conda activate pdfextractor
• 从终端执行PyCharm启动命令（如pycharm.sh），此时PyCharm会继承终端的完整PATH，自动识别tesseract

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