如何简化Python长路径下多模块指定对象的导入操作？

问题场景 #

你有一个包含多个.py文件的模块目录，仅需从每个子文件中导入单个对象，目录结构如下：

.
├── caller.py
└── functions
    ├── A.py
    ├── B.py
    └── C.py

尝试使用合并导入语句时触发语法错误：

from functions import (
    A.funcA as func_a,
    B.funcA as func_b,
    C.funcA as func_c
)

由于实际模块路径较长（如X.Y.Z.functions.A），希望避免重复书写冗长的路径前缀。

解决方案 #

方案1：通过__init__.py统一导出 #

在functions目录下创建或修改__init__.py文件，预先导入并导出需要的对象：

# functions/__init__.py
from .A import funcA as func_a
from .B import funcB as func_b
from .C import funcC as func_c

若为长路径X.Y.Z.functions，相对导入依然生效；若使用绝对导入，仅需写一次完整前缀：

# X/Y/Z/functions/__init__.py
from X.Y.Z.functions.A import funcA as func_a
from X.Y.Z.functions.B import funcB as func_b
from X.Y.Z.functions.C import funcC as func_c

之后在caller.py中即可直接导入：

from functions import func_a, func_b, func_c

方案2：使用importlib动态批量导入 #

如果需要导入的对象数量较多，可通过importlib实现动态批量导入，仅需修改一次路径前缀：

# caller.py
import importlib

# 定义导入规则：(子模块名, 目标对象名, 别名)
import_configs = [
    ("A", "funcA", "func_a"),
    ("B", "funcB", "func_b"),
    ("C", "funcC", "func_c"),
]

# 批量导入
prefix = "functions"  # 替换为实际长路径如"X.Y.Z.functions"
for mod_name, obj_name, alias in import_configs:
    module = importlib.import_module(f"{prefix}.{mod_name}")
    globals()[alias] = getattr(module, obj_name)

方案选择 #

• 若模块/对象数量较少，优先使用__init__.py的方式，符合Python模块导入的规范，可读性更强。
• 若需动态调整导入列表或导入数量较多，importlib动态导入的方式更灵活。

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