You need to enable JavaScript to run this app. Python跨目录导入模块报ModuleNotFoundError,加__init__.py仍失效
优惠活动
大模型
产品
解决方案
定价
更多

Python跨目录导入模块报ModuleNotFoundError,加__init__.py仍失效

问题核心成因

Python的模块定位逻辑是顺着sys.path列表里的每个路径,逐层查找要导入的模块/包。当你直接执行python 脚本路径.py时,Python会把当前被运行脚本所在的目录自动放到sys.path的最前面,不会主动把项目根目录纳入搜索范围。
你当前的执行场景是:进入classification目录下,直接运行python lstm_train.py。此时Python的搜索路径首位是./classification目录,当它要导入classification这个模块时,会在./classification目录下寻找有没有叫classification的子目录,显然这个路径下不存在这样的结构,就会直接抛出找不到模块的错误,根本不会回溯到上一层的项目根目录做搜索。
你之前在两个子目录下加的空__init__.py,作用只是把符合条件的目录标记为可导入的Python包,这个生效的前提是:对应目录的上一级路径在sys.path的搜索范围内。现在项目根本不在搜索路径里,就算两个子目录都加了包标记,Python也遍历不到根目录这一层,自然识别不到它们的存在。

为什么你的导入格式在当前场景失效

你使用的from <dir>.<script> import *属于基于项目根路径的绝对导入,这类导入正常工作需要满足两个条件:

  • 要导入的目录带有__init__.py(Python3.3+支持无标记的命名空间包,加文件也无影响),符合Python包的结构规范
  • 项目根目录本身必须存在于sys.path的模块搜索列表中

你现在只满足了第一个条件,搜索路径的锚点错在了classification子目录内部,相当于站在房间里找整栋楼的入口,根本定位不到根目录的层级,自然无法顺着目录结构找到对应模块。这种报错和__init__.py有没有添加没有直接关系,路径锚点不对时,包结构做的再规范也没法被Python识别。

可行的修正方案
  • 最优方案:退出classification子目录,切回最外层的项目根目录,使用模块方式运行脚本:python -m classification.lstm_train。这种运行方式下,Python会自动把当前所在的项目根目录加入搜索路径,所有基于根目录的绝对导入都可以正常生效。
  • 兼容现有运行习惯的方案:如果必须在classification目录下直接执行lstm_train.py,就在所有导入语句的最开头,手动将项目根目录加入sys.path:
    import sys
    import os
    # 定位当前脚本所在classification目录的上一级,即项目根目录
    PROJECT_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
    sys.path.insert(0, PROJECT_ROOT)
    
    加入这段代码后,Python的搜索范围就会覆盖项目根目录,后续的导入逻辑就能正常跑通。
  • 临时调试方案:在运行脚本前手动配置PYTHONPATH环境变量,将项目根目录追加到Python的搜索路径中。这种方式每次新开终端都需要重新配置,仅适合临时排障使用,不适合长期项目维护。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.20 14:54:03