docTR安装后导入报ModuleNotFoundError，本地PyCharm环境求助排查

先排查解释器配置问题 #

• 打开PyCharm的File > Settings > Python Interpreter（Windows/Linux）或PyCharm > Settings > Python Interpreter（Mac）
• 确认当前选中的解释器是你安装docTR的conda/venv环境
• 如果列表里找不到docTR，点击右上角齿轮图标，选择Add，手动指定你创建的环境路径（比如conda环境路径一般是Anaconda3/envs/[你的环境名]/python.exe，venv则是项目下的venv/Scripts/python.exe）

确认安装命令正确 #

• 用pip安装TensorFlow版时，必须执行：

  pip install python-doctr[tf]  # CPU版
  # GPU版执行：
  pip install python-doctr[tf-gpu]
  

• 克隆Git仓库安装的话，必须进入克隆后的doctr文件夹，再执行：

  pip install .
  # 开发模式（修改源码实时生效）执行：
  pip install -e .
  

确保环境激活后再操作 #

• 若在PyCharm外的终端安装docTR，需先激活对应环境再启动PyCharm：
  • conda环境：conda activate [你的环境名]
  • venv环境：Windows用venv\Scripts\activate，Linux/Mac用source venv/bin/activate
• 也可直接在PyCharm内置终端里激活环境，重新安装一次docTR

避免命名冲突 #

• 检查项目目录中是否存在doctr.py文件或doctr文件夹——这类命名会直接覆盖第三方包的导入路径
• 若有，立即重命名或删除这些文件/文件夹

验证安装有效性 #

在PyCharm终端里执行以下命令，确认docTR的安装路径：

import doctr
print(doctr.__file__)

如果输出路径是项目文件夹内的文件，说明存在命名冲突；如果是环境的site-packages/doctr目录，说明安装正常，重新尝试导入语句即可。

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