如何让Python包自动导入模块方法，无需手动更新__init__.py？

这是个很实用的需求，尤其是当你不想每次新增模块都手动修改__init__.py的时候。下面是能实现这个功能的__init__.py代码，我会一步步拆解它的工作逻辑：

import os
import importlib

# 获取当前包所在的目录路径
package_directory = os.path.dirname(__file__)

# 遍历目录下的所有文件，筛选出有效模块文件
for filename in os.listdir(package_directory):
    # 只处理.py文件，且排除__init__.py本身
    if filename.endswith('.py') and filename != '__init__.py':
        # 提取模块名称（去掉后缀.py）
        module_name = filename[:-3]
        # 动态导入当前包内的目标模块
        module = importlib.import_module(f'.{module_name}', package=__name__)
        # 遍历模块中的所有顶级成员，将符合条件的对象暴露到包的命名空间
        for member_name, member_obj in module.__dict__.items():
            # 只导入非下划线开头的可调用对象（比如函数）
            if callable(member_obj) and not member_name.startswith('_'):
                globals()[member_name] = member_obj

代码解释 #

• 获取包目录：os.path.dirname(__file__)会拿到当前__init__.py所在的目录，确保不管包被放在哪个路径下，都能正确找到内部模块。
• 筛选模块文件：通过后缀.py和排除__init__.py，避免导入无关文件或者循环导入自身。
• 动态导入模块：用importlib.import_module实现相对导入，.{module_name}表示当前包下的子模块，package=__name__指定了当前包的名称，保证导入路径正确。
• 暴露成员到包命名空间：遍历模块的__dict__（模块的所有成员都存在这里），筛选出可调用的（比如函数）且不是私有约定（下划线开头）的成员，把它们添加到包的全局命名空间里，这样导入包后就能直接通过包名调用这些方法了。

注意事项 #

• 命名冲突问题：如果不同模块里有同名的函数，后导入的模块中的函数会覆盖之前的。如果担心这个问题，可以考虑修改逻辑，比如给函数加上模块名前缀，或者调整导入规则。
• 性能考量：如果包内有大量模块，每次导入包时都会遍历并导入所有模块，可能会增加启动时间。小项目基本不受影响，大项目可以根据实际情况权衡是否使用这种方式。
• 自定义导入范围：如果你想导入模块里的类或者其他对象，可以修改callable(member_obj)的判断条件，比如改成isinstance(member_obj, (type, function))就能同时导入类和函数；如果要导入所有非私有成员，直接去掉callable(member_obj)的判断即可。
• 测试验证：按照你的示例结构，当你在Jupyter Lab中执行import my_package as mpgk后，直接调用mpgk.add(2,3)或者mpgk.sub(10,4)就能正常执行对应模块里的函数，新增模块后也不需要修改__init__.py，重启内核重新导入包就能识别新模块的方法。

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