为何import nilearn失效，而import nilearn.datasets可正常运行？

直接原因 #

执行import nilearn时，Python仅加载nilearn的顶层模块（即包根目录下的__init__.py），并不会自动加载所有子模块。nilearn.datasets作为独立子模块，默认不会被挂载到主包的命名空间中，因此直接访问会触发AttributeError。而import nilearn.datasets会明确加载该子模块，并将其绑定到nilearn主包下，此时就能正常访问其中的属性。

是否属于普遍现象？ #

这是Python包的默认行为，绝大多数标准库和第三方包都遵循这个规则：

• 导入import numpy后，直接访问numpy.linalg会报错，必须先执行import numpy.linalg；
• 导入import pandas后，pandas.plotting也需要单独导入才能通过主包直接访问。

深层原理 #

Python模块加载采用**懒加载（Lazy Loading）**机制，核心逻辑如下：

1. 模块按需加载：只有当明确导入某个子模块时，解释器才会查找并执行该子模块的代码；
2. 主包的__init__.py控制自动导入行为：如果包的__init__.py中没有添加from . import datasets或import nilearn.datasets这类语句，子模块就不会被自动挂载到主包命名空间；
3. 性能优化考量：这种设计能减少初始导入的时间和内存开销，避免加载不必要的代码。

例外情况 #

少数包会在主包的__init__.py中主动导入常用子模块，比如import requests后可直接使用requests.get，这是因为requests的__init__.py中已经导入了requests.api模块，并将get等方法暴露到主包命名空间。

参考资料 #

• Python官方文档：模块导入系统章节，涵盖模块查找、加载的完整流程；
• nilearn源码：查看包根目录下的__init__.py，确认是否存在自动导入子模块的逻辑；
• Python包设计最佳实践文档：解释默认不自动导入子模块的设计初衷。

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