如何在 Python 中通过 __init__.py 简化模块导入路径-Python教程-PHP中文网

如何在 Python 中通过 __init__.py 简化模块导入路径

通过合理配置子包的 __init__.py 文件，可将 from web.web import * 简化为 from web import *，无需移动文件，仅需在 web/__init__.py 中显式重新导出 web.py 中的内容。

通过合理配置子包的 `__init__.py` 文件，可将 `from web.web import *` 简化为 `from web import *`，无需移动文件，仅需在 `web/__init__.py` 中显式重新导出 `web.py` 中的内容。

在 Python 包结构中，__init__.py 不仅用于标识目录为包，更承担着“包级接口定义”的关键角色。它决定了外部代码通过 import web 或 from web import * 能访问哪些符号。默认情况下，from web import * 仅导入 web/__init__.py 中定义或显式导入并重新导出的名称（遵循 __all__ 列表，若未声明则依赖模块级变量）。

要实现从 from web.web import * 到 from web import * 的简化，只需在 web/__init__.py 中导入并重新暴露目标模块的内容。例如：

# web/__init__.py
from .web import *
from .utils import *  # 如需同时暴露 utils.py 中的内容，也可一并导入

对应地，确保 web/web.py 中定义了期望导出的变量或函数：

Python Testing

Python 测试速查：运行 pytest、使用 mock/patch、参数化、fixtures、异步、覆盖率测试。

下载

# web/web.py
TEST = "test"
CONFIG = {"debug": True}
def handle_request():
    return "OK"

此时，在 main.py 中即可直接使用：

# main.py
from web import *

print(TEST)           # 输出: test
print(CONFIG)         # 输出: {'debug': True}
print(handle_request())  # 输出: OK

⚠️ 注意事项：

from web import * 的行为依赖于 web/__init__.py 中实际导入并绑定的名称；未被 from .web import * 拉入 __init__.py 命名空间的符号不会被导出。
强烈建议显式声明 __all__ 以明确控制通配符导入范围，提升可维护性与可读性：

# web/__init__.py
from .web import TEST, CONFIG, handle_request
from .utils import read_config

__all__ = ["TEST", "CONFIG", "handle_request", "read_config"]

这样既避免了 * 导入带来的命名污染风险，又保证了接口清晰、可控。最终，你保留了清晰的目录结构（web/ 下分隔 web.py 和 utils.py），又实现了简洁、语义明确的顶层导入方式。