直接执行包中__init__.py文件时触发ImportError的原因咨询

你的问题场景复现 #

先梳理下你遇到的具体情况：

• 你的TestPackage包下的__init__.py代码如下：

import sys

sys.path.append(".")
from . import module

• 包的目录结构：

TestPackage
├── __init__.py
└── module.py

• 执行命令：python PATH_TO_INIT.PY后，触发错误：

ImportError: attempted relative import with no known parent package

• 你的疑问：有没有人知道我为啥会碰到这个错误？

原因解释 #

兄弟，这个问题其实是Python模块/包机制的规则导致的。当你直接用python命令运行__init__.py时，Python会把这个文件当成独立的普通脚本，而不是TestPackage这个包的组成部分。

你写的from . import module属于相对导入，这种导入方式是专门给包内部模块之间互相引用用的，它依赖Python识别当前文件所属的父包上下文。但直接执行脚本时，Python不会为这个文件建立包结构的上下文，它根本不知道这个文件属于哪个包，自然就找不到所谓的“父包”，所以就抛出这个导入错误了。

哪怕你加了sys.path.append(".")也没用，这只是把当前工作目录加到模块搜索路径里，并没有告诉Python这个文件是包的一部分。

可行的解决办法 #

给你几个实用的方案，你可以根据需求选：

• 推荐方案：用模块方式运行包
  别直接执行__init__.py，先切换到TestPackage的上级目录（就是包含TestPackage文件夹的那个目录），然后执行：

  python -m TestPackage
  

  这种方式下，Python会把TestPackage当成标准包来处理，自然就能识别内部的相对导入了。

• 折中方案：改用绝对导入
  如果一定要直接运行这个文件，可以把from . import module改成import module，不过要注意，这种写法可能会在包被正常导入（比如其他脚本里import TestPackage）时出现模块重复导入的问题，只适合临时测试用。

• 兼容方案：让代码同时支持两种场景
  可以加个异常捕获，让代码既可以当包的一部分被导入，也可以直接执行：

  import sys
  from pathlib import Path
  
  # 把当前文件所在的包目录加到搜索路径
  sys.path.append(str(Path(__file__).parent))
  
  try:
      # 优先尝试相对导入（当作为包导入时）
      from . import module
  except ImportError:
      # 直接执行时用绝对导入
      import module
  

备注：内容来源于stack exchange，提问作者Pacific East