IntelliJ IDEA Python项目调试时文件夹存在仍抛出ModuleNotFound错误
IntelliJ运行Python项目ModuleNotFoundError排查方案

已完成绝对导入配置、解释器设置、缓存清理的前提下,可按以下步骤继续排查:
- 标记源代码目录为Sources Root
右键点击存放自定义模块的上层目录,选择Mark Directory as→Sources Root,该操作会自动将目录加入运行时PYTHONPATH,解决导入路径不匹配问题。 - 修正运行配置参数
点击右上角运行配置下拉框 →Edit Configurations,找到对应Python脚本的运行项,调整配置:- 将
Working directory设置为项目根目录,而非脚本所在子目录 - 勾选
Add content roots to PYTHONPATH和Add source roots to PYTHONPATH两个选项
- 将
- 验证依赖安装路径匹配
打开File→Project Structure→SDKs,选中正在使用的Python解释器,在下方依赖列表确认报错的模块确实存在于该解释器的安装列表中。如果缺失,直接使用IntelliJ内置终端执行pip install 对应模块名安装,避免外部终端安装到其他解释器环境。 - 补充包标识文件
如果导入的是自定义包模块,在每个作为包导入的目录下新建空的__init__.py文件,适配IntelliJ的包识别规则。
内容的提问来源于stack exchange,提问作者niharikaat
相关产品推荐
相关产品推荐

