Python相对导入报错：尝试相对导入但未知父包问题排查

核心原因 #

直接执行packa/__init__.py时，Python将该文件视为独立顶层脚本，而非packageTest包的子模块，因此无法识别..packb这种相对导入的父包结构。

解决方案（无需修改sys.path） #

方案1：以模块方式运行（推荐） #

在packageTest的父目录打开终端，执行以下命令：

python -m packageTest.packa

该命令会让Python将packageTest识别为完整包，packa作为其子模块加载，此时相对导入..packb可以正常解析。

同时需要修正代码中的两处问题，确保能正常输出内容：

1. packa/init.py：导入后需实例化类触发打印（原代码仅调用类对象，未执行__init__）：

from ..packb import hello
# 实例化hello类，执行__init__中的打印逻辑
hello.hello()

2. packb/init.py：改用相对导入更符合包规范，同时实例化类：

from . import hello
hello.hello()

方案2：通过环境变量指定包路径 #

如果需要直接运行packa/__init__.py，可先将packageTest的父目录加入PYTHONPATH环境变量：

• Linux/macOS终端：

export PYTHONPATH=$(pwd):$PYTHONPATH
# 执行前需切换到packageTest的父目录

• Windows命令行：

set PYTHONPATH=%cd%;%PYTHONPATH%
# 执行前需切换到packageTest的父目录

之后再运行：

python packa/__init__.py

补充说明 #

__init__.py的作用是标记目录为Python包，但仅当包以模块形式被加载（通过import或-m参数运行）时，包内的相对导入才能生效。直接执行包内脚本文件时，Python不会关联上层包结构，导致相对导入失败。

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