如何解决Python的“ImportError: attempted relative import with no known parent package”错误

为什么会触发ImportError: attempted relative import with no known parent package #

你用from . import common属于包内相对导入语法，但直接运行脚本时，Python会把当前脚本当作独立的顶层执行文件，而非某个包的子模块。此时Python不会将脚本所在目录识别为包结构，自然找不到解析相对路径所需的“父包”。

Python包到底是什么？什么时候目录不算包？ #

• Python包的核心定义：
  包本质是包含__init__.py文件的目录（Python 3.3+支持无__init__.py的命名空间包，但常规场景下这个文件是标识包的关键），但更重要的是：这个目录必须被Python以包的方式导入，而非作为脚本的运行目录。
• 目录不算包的场景：
  • 直接运行目录下的.py文件：此时Python将该文件视为顶层脚本，它所在的目录不会被纳入包结构，模块的__package__属性为空。
  • 目录不在sys.path中：Python只会从sys.path列表里的路径查找模块/包，若你的目录不在其中，即便有__init__.py也不会被识别为包。

“无父包”是什么意思？怎么产生的？ #

相对导入（.代表当前包，..代表父包）依赖于当前模块的包层级上下文。当脚本被直接运行时：

• 当前模块的__package__属性为空字符串，Python无法确定它属于哪个包结构。
• 没有这个上下文，相对导入的路径就失去了解析基准，因此报错“无已知父包”。

解决方法 #

• 改用绝对导入
  直接用import common或者from common import xxx即可，因为运行脚本时，当前目录默认会被加入sys.path，Python能直接找到common.py模块。
• 以包的方式运行脚本
  给你的目录起个名字（比如my_project），确保目录内有__init__.py（可以是空文件），然后用以下命令运行脚本：

  python -m my_project.your_script
  

  此时Python会把my_project识别为包，相对导入from . import common就能正常工作。
• 确认__init__.py的位置
  确保__init__.py和common.py、你的所有脚本在同一个目录下，它是Python识别常规包的必要标志。

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