Python子包内模块函数的正确调用方式（需使用subpackage.module.function语法）

首先，你在subpackage/__init__.py中导入module_d和module_e的做法完全正确，这是Python里让包内模块能通过包名直接访问的常规操作。

为什么你最初的代码会失败？因为当你执行from mypackage import subpackage时，Python只会加载subpackage/__init__.py，不会自动把包内的所有子模块都加入到subpackage的命名空间里。所以直接访问subpackage.module_d时，Python找不到这个属性——直到你在__init__.py里把这些模块导入进来，它们才会成为subpackage的公开成员。

这种方式在很多知名Python包中都有应用，比如requests：你能直接用requests.get()，本质就是requests的__init__.py把requests.api里的get函数导入到了包的顶层命名空间。

其他替代方案 #

如果你不想修改__init__.py，或者有更灵活的需求，还有几种可选方式：

• 直接导入目标模块：在module_c.py里直接导入需要的模块，不需要依赖__init__.py的配置：

  from mypackage.subpackage import module_d
  module_d.function_0()
  

  这种方式更直接，适合只在少数模块中引用的场景，避免了对包初始化文件的修改。

• 使用相对导入：在包内部的模块之间，你可以用相对路径来导入，这样不用写完整的包名，更灵活：

  from . import module_d
  module_d.function_0()
  

  这里的.代表当前包（也就是subpackage）。不过要注意：相对导入只能在模块作为包的一部分被导入时生效，如果直接运行module_c.py（比如python module_c.py）会报错，因为此时它不是包的一部分。

• 用__all__定义导出列表：如果你想支持from subpackage import *的方式导入所有子模块，但又不想把它们直接加入到subpackage的命名空间，可以在subpackage/__init__.py中添加：

  __all__ = ['module_d', 'module_e']
  

  但这种方式不能让你直接用subpackage.module_d访问，用户需要自己导入模块，所以可能不符合你的核心需求，但也是一种包组织的规范做法。

总结 #

如果你的核心需求就是要通过subpackage.module_d.function_0()这种语法调用，那你当前的方案是最优选择之一，既清晰又符合Python的包设计规范。如果只是在module_c.py内部需要调用，相对导入或直接导入模块会更简单。

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