Python多层目录导入报No module named 'commands'错误
错误根本原因
Python 模块导入时会严格按照sys.path中记录的目录列表检索目标模块,默认初始化的检索路径包含项目运行的根目录(也就是本地调试或Heroku部署中,对应日志里的/app路径)。
结合你的项目结构和报错日志来看:
- 你在根目录
main.py中写from nyaizhel_includes import includemain能正常执行,是因为nyaizhel_includes是直接放在根目录下的文件夹,能被顶层检索路径命中。 - 但你实际的
commands目录是嵌套在nyaizhel_includes文件夹内部的,并不是和main.py同级的顶层目录。你在includemain.py里写from commands import astolfo这类语句,是直接从顶层检索路径找名为commands的包,而根目录下根本不存在这个文件夹,自然会抛出ModuleNotFoundError。
这个问题在本地调试时往往不会暴露:如果之前你是在
nyaizhel_includes目录下直接运行脚本,当时的工作目录就是nyaizhel_includes,自然能找到同目录下的commands文件夹;但部署到Heroku后,运行入口是根目录的main.py,工作目录切换到了根目录,检索路径的基准发生变化,错误就会直接抛出。
对应解决方法
- 方案1:使用规范的包导入路径(推荐)
直接把导入语句从原来的顶层commands路径,改成符合包结构的完整导入路径,比如:
也可以用同包相对导入的写法,跨环境适配性更强:# 绝对导入写法 from nyaizhel_includes.commands import astolfo from nyaizhel_includes.commands import narutobanner from nyaizhel_includes.commands import rgirl
注意:这种相对导入的写法,不支持直接把# 相对导入写法,点代表当前includemain.py所在的目录(即nyaizhel_includes包根目录) from .commands import astolfo from .commands import narutobanner from .commands import rgirlincludemain.py作为独立脚本运行,必须通过根目录的main.py作为入口触发导入逻辑,否则会抛出相对导入相关报错,这和你当前的部署模式是完全匹配的。
这种写法完全遵循Python包的导入规范,不会出现路径匹配错误,也不存在不同部署环境下的路径适配问题。 - 方案2:动态修改模块检索路径(兼容旧写法)
如果你不想改动原有的导入语句,希望保留from commands import xxx的写法,可以在includemain.py的最开头,把commands所在的目录手动加入Python的模块检索路径:
这种方法能快速兼容原有代码,但会全局修改模块检索路径,存在和其他同名包冲突的风险,不推荐长期使用。import sys import os # 获取当前includemain.py文件的绝对路径,定位到它所在的nyaizhel_includes目录 current_package_dir = os.path.dirname(os.path.abspath(__file__)) # 将该目录加入模块检索列表,让Python能找到内部的commands子目录 sys.path.insert(0, current_package_dir)
内容的提问来源于stack exchange,提问作者norahCii
相关产品推荐
相关产品推荐

