Python 中导入包时为何必须显式导入子模块？-Python教程-PHP中文网

Python 中导入包时为何必须显式导入子模块？

python 的 import 机制不会自动递归导入子包或子模块，仅导入顶层包仅会执行其 __init__.py（若存在），而不会加载其内部结构；因此 import paho 并不等价于 import paho.mqtt.client，后者才是实际引入所需类和函数的必要操作。

python 的 import 机制不会自动递归导入子包或子模块，仅导入顶层包仅会执行其 __init__.py（若存在），而不会加载其内部结构；因此 import paho 并不等价于 import paho.mqtt.client，后者才是实际引入所需类和函数的必要操作。

在 Python 中，import 语句的作用是将指定模块或包加载到内存，并将其绑定到当前命名空间中的名称。关键在于：导入一个包，并不意味着其所有子模块或子包也被自动导入。

以 paho 为例：

import paho 仅加载 paho 包本身（即执行 paho/__init__.py），但该文件通常为空或仅做最小初始化，并不会自动导入 paho.mqtt 或 paho.mqtt.client；
因此，即使你使用全限定名 paho.mqtt.client.Client，Python 仍需确保 paho.mqtt.client 模块已被加载——否则会抛出 AttributeError（如 'module' object has no attribute 'mqtt'）或 ModuleNotFoundError（取决于具体包结构）；
这就是为什么 import paho.mqtt.client 是必需的：它显式触发 client.py 模块的加载与注册，使 paho.mqtt.client 路径在运行时有效。

✅ 正确且简洁的写法（推荐）：

Python Testing

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

下载

import paho.mqtt.client as mqtt_client
import paho.mqtt.enums as mqtt_enums

client = mqtt_client.Client(mqtt_enums.CallbackAPIVersion(2))

✅ 或一次性导入所需路径（更清晰）：

from paho.mqtt.client import Client
from paho.mqtt.enums import CallbackAPIVersion

client = Client(CallbackAPIVersion(2))

⚠️ 注意事项：

import paho 在本例中完全冗余，可安全删除；
不要依赖“链式点号访问”来绕过显式导入——Python 不支持“懒加载式路径解析”；
若希望缩短多处引用，优先使用 as 别名，而非保留冗长的全路径；
某些包（如 numpy 或 torch）在其顶层 __init__.py 中主动导入常用子模块，属于特例设计，不可推广为通用行为；paho 并未采用此模式。

总结：Python 的导入是显式、惰性且非递归的。理解这一点，能避免常见命名空间错误，并写出更可靠、可维护的导入逻辑。