Python项目单模块运行报ModuleNotFoundError的相关问题咨询

1. 你的导入写法是否符合规范？ #

• 你当前的绝对导入写法完全符合Python官方推荐的包结构开发规范，项目根目录下正常导入模块可运行就已经验证了写法的正确性，不需要调整导入逻辑。

2. 直接运行单模块报错的核心原因 #

Python运行单个脚本文件和以包模块身份运行的逻辑有本质差异：

• 直接执行.py脚本时，Python会将该脚本所在的目录加入sys.path的搜索优先级首位，不会自动加入你执行命令时的工作目录
• 同时该脚本的__name__属性会被设为__main__，不再被识别为原包层级下的project.b.bb.bbb模块
  你执行python3 -i project/b/bb/bbb.py时，sys.path里加入的是/path/to/project/b/bb/路径，该路径下不存在project包，自然抛出ModuleNotFoundError。

3. 符合规范的单模块运行方式 #

不要直接执行脚本文件，使用Python的-m参数以模块身份运行，在项目根目录下执行以下命令即可：

python3 -i -m project.b.bb.bbb

-m参数会自动将你当前的工作目录加入sys.path，同时按照完整的点分模块路径定位目标模块，保留原有的包层级关系，原有导入语句不需要任何修改即可正常运行。

4. 单模块调试建议 #

• 日常开发调试单模块时统一使用-m参数启动，无论是正常运行还是加-i进入交互调试，都不需要修改代码内的导入逻辑
• 使用IDE调试时，将对应运行配置的启动模式改为「模块运行(Module)」，填入模块的完整点分路径project.b.bb.bbb，同时将工作目录设为项目根目录即可
• 如果该模块需要作为可执行入口使用，将执行逻辑放到if __name__ == '__main__':代码块中，配合-m参数运行不会影响其他模块导入该文件

内容的提问来源于stack exchange，提问作者osflw