python - python __all__ 模块级变量有什么用？

Question

我在 python/Lib 源代码中看到了很多，但我不知道它是干什么用的。

我认为它用于限制模块的可访问成员。所以只有 __all__ 处的元素会在 dir(module) 时出现。

我做了一个小例子，发现它没有按预期工作。

那么... python __all__ 模块级变量是干什么用的？

Answer 1

它有两个目的:

1. 任何阅读源代码的人都会知道公开的公共(public) API 是什么。它不会阻止他们在私有(private)声明中四处寻找，但确实提供了一个很好的警告。

2. 使用 from mod import * 时，只会导入 __all__ 中列出的名称。在我看来，这并不重要，因为导入所有内容真的是个坏主意。