如何在主脚本中提升子包层级以简化Python导入路径？

为什么当前写法无法直接import pack.sub2？ #

你在pack/__init__.py里执行from .sub1 import sub2，只是把sub2子包绑定到了pack模块的命名空间（所以dir(pack)能看到它），但这并没有修改Python的模块搜索规则：

• Python查找模块时，会优先检查sys.modules缓存，若未找到则根据当前包的__path__属性（默认是包所在的目录路径）遍历查找子目录/.py文件。
• 你的sub2实际位于pack/sub1/sub2，而pack默认的__path__只有pack/目录，因此Python无法识别pack.sub2这个模块路径，自然报错。
• import pack.sub1能正常运行，是因为pack/sub1确实存在于pack的默认搜索路径下，符合模块查找逻辑。

实现简化路径导入的三种方法 #

方法1：修改包的__path__搜索路径 #

在pack/__init__.py中，将sub1目录添加到pack的模块搜索路径里，让Python查找pack子模块时遍历该目录：

from .sub1 import sub2
import os

# 将sub1目录加入pack的搜索路径
__path__.append(os.path.join(os.path.dirname(__file__), 'sub1'))

修改后，import pack.sub2会在pack/sub1目录下找到sub2子包，成功完成导入。

方法2：手动注册sys.modules缓存 #

直接把pack.sub2映射到已导入的sub1.sub2，让Python的模块缓存识别这个路径：

from .sub1 import sub2
import sys

# 把pack.sub2注册到模块缓存
sys.modules['pack.sub2'] = sub2

这种方式更直接，Python导入时会优先读取sys.modules，找到对应条目后直接返回，无需再去文件系统查找。

方法3：创建转发子包（规范友好型） #

在pack目录下新建sub2/__init__.py，通过转发实现规范的子包结构：

# pack/sub2/__init__.py
from ..sub1.sub2 import *
from ..sub1.sub2 import sub2 as __internal_sub2__

# 同步原sub2的导出列表
__all__ = __internal_sub2__.__all__ if hasattr(__internal_sub2__, '__all__') else [
    name for name in dir(__internal_sub2__) if not name.startswith('_')
]

这种方式让pack/sub2成为真实的子包，既符合Python模块规范，也能让IDE正常提供代码提示。

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