关于scikit-learn中__init__.py导入模块后设置__all__的疑问

首先得明确，__all__和__init__.py里的import语句作用完全不同，一点都不冗余：

1. 精准控制from ... import *的导入范围 #

虽然__init__.py里的import会把模块加载到包的命名空间里，但默认情况下，from sklearn.metrics import *只会导入名字不以下划线开头的对象。scikit-learn用__all__明确列出所有允许被批量导入的公共模块/对象，确保用户用*导入时，只会拿到官方认可的API，不会不小心导入内部的辅助模块、临时变量或者测试用工具。

2. 明确公共API的边界 #

__all__相当于给用户一份清晰的「公开接口清单」——里面的内容是官方承诺会维护、支持的API。即使包内部结构调整（比如某个模块被移到子文件夹里），只要__all__里的名字不变，用户的代码就不会因为内部重构而崩溃。反过来，如果没有__all__，用户可能会误用到一些内部未公开的模块，这些模块随时可能在版本更新中被移除或修改，导致代码报错。

3. 避免命名冲突 #

假设__init__.py里为了内部逻辑导入了一些和公共API无关的名字（比如某个辅助函数叫_utils），没有__all__的话，用户用*导入时就可能把这些内部名字也导进来，和自己代码里的变量重名，引发意外问题。而__all__可以过滤掉这些不需要暴露的名字。

如果移除__all__会发生什么？

• 用from ... import *导入时，只能拿到__init__.py里所有非下划线开头的名字，可能漏掉一些官方想让用户用的API（比如如果某个公共模块的名字刚好带下划线的情况）。
• 用户无法快速区分哪些是公共API、哪些是内部实现，容易依赖未被官方支持的功能，后续版本升级时代码兼容性无法保障。
• 可能意外导入内部的辅助变量或模块，造成命名冲突或不可预期的行为。

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