PyCharm运行程序时所有模块均报ModuleNotFoundError问题求助

问题情况 #

• 在PyCharm中运行项目代码时，所有导入的模块均触发ModuleNotFoundError报错
• 已通过PyCharm「设置→项目→Python解释器→+号」完成相关模块的安装
• 同一虚拟环境的Python控制台中，导入模块可正常运行

实用解决步骤 #

• 核对运行配置的解释器
  点击PyCharm右上角运行配置下拉菜单，选择「Edit Configurations...」，确认当前运行配置的「Python interpreter」和项目设置里的虚拟环境完全一致。不少情况是运行配置误选了全局解释器而非项目专属虚拟环境。

• 刷新PyCharm缓存
  打开「File→Invalidate Caches...」，选择「Invalidate and Restart」，让PyCharm重新加载解释器和模块数据，缓存过期会导致模块识别异常。

• 对比路径差异
  在Python控制台执行：

  import sys
  print(sys.path)
  

  复制输出的路径列表；再在报错的代码开头添加这段代码并运行，对比两者的sys.path。如果模块安装路径不在运行代码的路径列表中：

  • 右键项目根目录→「Mark Directory as」→「Sources Root」
  • 或者在运行配置的「Environment variables」中添加PYTHONPATH变量，值为模块的安装路径

• 终端重新安装模块
  打开PyCharm的Terminal，确认已激活项目虚拟环境（终端前缀会显示虚拟环境名称），执行pip install [模块名]重新安装模块，避免GUI安装时的路径异常问题。

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