使用__init__.py导入子包失败，如何正确暴露指定类？

首先，咱们先梳理下常见的错误原因，再结合你调整文件后的场景给出正确的配置方案：

常见踩坑点 #

• 相对导入路径写错：在主包的__init__.py里导入内部模块时，没使用正确的相对路径格式
• 未将目标类挂载到主包命名空间：即使内部导入了Schedule，但主包的__init__.py没把它暴露给外部
• 调整文件后出现隐性循环依赖：模块间互相导入导致的初始化错误

正确配置步骤 #

假设你的最终包结构是这样的（如果和你的实际结构有出入，按需调整路径即可）：

package/
├── __init__.py
├── subpackageA/
│   ├── api.py
│   └── action.py
└── subpackageB/
    └── start.py

1. 确保subpackageB/start.py的Schedule类定义正常 #

# subpackageB/start.py
class Schedule:
    def __init__(self):
        self.task_queue = []
    
    def schedule_task(self, task):
        self.task_queue.append(task)
    # 其他业务方法...

2. 配置主包的__init__.py #

要让外部导入package时直接能拿到Schedule，必须在主包的__init__.py里明确导入这个类，同时可以通过__all__控制from package import *的暴露范围：

# package/__init__.py
# 从subpackageB的start模块导入Schedule类
from .subpackageB.start import Schedule

# 限制import *时仅暴露Schedule（可选，但推荐规范包的接口）
__all__ = ["Schedule"]

3. 内部模块的导入规范（针对你调整后的api.py、action.py） #

如果内部模块需要互相调用，一定要用相对导入，比如在subpackageA/api.py里导入action.py的类：

# subpackageA/api.py
# 用相对路径导入同目录下的action模块
from .action import InternalActionClass

这种方式既避免了绝对导入的路径问题，也符合Python包内部引用的规范。

验证导入是否生效 #

在包外部的代码里测试：

# 测试代码
import package
# 直接通过主包访问Schedule
my_schedule = package.Schedule()

# 或者用from导入
from package import Schedule
my_schedule = Schedule()

如果能正常实例化Schedule，说明配置成功了。

额外提醒 #

• 主包的__init__.py尽量保持简洁，只做必要的接口暴露，不要导入无关的内部模块
• 如果调整文件后出现循环导入，检查模块间的依赖关系，把公共逻辑抽离到独立的工具模块里

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