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:
加入这段代码后,Python的搜索范围就会覆盖项目根目录,后续的导入逻辑就能正常跑通。import sys import os # 定位当前脚本所在classification目录的上一级,即项目根目录 PROJECT_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) sys.path.insert(0, PROJECT_ROOT) - 临时调试方案:在运行脚本前手动配置
PYTHONPATH环境变量,将项目根目录追加到Python的搜索路径中。这种方式每次新开终端都需要重新配置,仅适合临时排障使用,不适合长期项目维护。
内容的提问来源于stack exchange,提问作者Lucas Azevedo

