You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

IntelliJ IDEA Python项目调试时文件夹存在仍抛出ModuleNotFound错误

IntelliJ运行Python项目ModuleNotFoundError排查方案

报错截图
已完成绝对导入配置、解释器设置、缓存清理的前提下,可按以下步骤继续排查:

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

内容的提问来源于stack exchange,提问作者niharikaat

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.02 01:27:03