Python相对导入报错原因解析及正确实现方法咨询

目录结构 #

├── package
│   ├── subpackage1
│   │   └── module1.py
│   └── subpackage2
│       └── module2.py

模块代码 #

module1.py #

def module1():
    print('hello world')

初始报错的module2.py #

from ..subpackage1.module1 import module1

module1()

报错原因 #

直接执行python3 module2.py时，Python会把module2.py当作独立的顶层脚本，而非package父包下的子模块。相对导入（..语法）依赖包层级上下文，只有当模块属于某个包结构时，Python才能识别其父包位置。此时没有父包上下文，自然触发ImportError: attempted relative import with no known parent package。

你用sys.path.append()的方法本质是把subpackage1加到了Python的模块搜索路径，相当于把module1当作顶层模块导入，这是绕开包层级的变通方案，并非真正的相对导入。

实现相对导入的正确方法 #

要让相对导入生效，必须让Python将module2.py识别为package包下的子模块，以下是两种可行方式：

方式1：从包外部以模块形式运行 #

1. 切换到package目录的父目录（即与package平级的目录）
2. 使用-m参数以模块方式启动module2：

python3 -m package.subpackage2.module2

这种方式下，Python会把package视为根包，module2作为package.subpackage2的子模块，..subpackage1能正确定位到同级子包，相对导入正常工作。

方式2：显式标记包结构（可选） #

Python 3.3+支持命名空间包，无需手动创建__init__.py也能识别包结构，但如果是旧版本或想明确标记包，可在package、subpackage1、subpackage2目录下都创建空的__init__.py文件，目录结构变为：

├── package
│   ├── __init__.py
│   ├── subpackage1
│   │   ├── __init__.py
│   │   └── module1.py
│   └── subpackage2
│       ├── __init__.py
│       └── module2.py

之后仍按方式1，从父目录执行python3 -m package.subpackage2.module2即可。

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