VS Code Ubuntu环境下pytesseract已安装却报ModuleNotFoundError求助

可能遗漏的排查环节 #

• VS Code未绑定目标虚拟环境
  确认VS Code左下角状态栏显示的Python解释器是你创建的venv环境路径（如./venv/bin/python）。如果不是，点击状态栏的解释器选择器，切换到正确的venv解释器后重启VS Code。

• pip命令与虚拟环境不匹配
  确保安装pytesseract时使用的是venv内的pip，而非系统全局pip。执行命令时要指定路径：

  ./venv/bin/pip install pytesseract
  

• VS Code代码索引未更新
  打开命令面板（Ctrl+Shift+P），执行Python: Refresh IntelliSense，强制更新扩展的代码索引，避免因缓存导致的模块识别异常。

• 检查虚拟环境完整性
  确认venv的site-packages目录下，pytesseract文件夹和对应的pytesseract-X.X.X.dist-info目录完整，若有文件损坏，删除这两个目录后重新用venv的pip安装。

pytesseract替代安装方式 #

• 使用conda安装（适用于conda环境）
  若切换到conda虚拟环境，可通过conda-forge源安装，自动处理依赖：

  conda install -c conda-forge pytesseract
  

• 手动安装源码包

  1. 先安装git：sudo apt install git
  2. 进入venv的site-packages目录（替换X.X为你的Python版本，如3.10）：

     cd ./venv/lib/pythonX.X/site-packages/
     

  3. 克隆源码并安装：

     git clone https://github.com/madmaze/pytesseract.git
     cd pytesseract
     python setup.py install
     

• 更换pip源重新安装
  若默认pypi源安装的包存在损坏，换国内源重新安装：

  ./venv/bin/pip install pytesseract -i https://pypi.tuna.tsinghua.edu.cn/simple
  

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