__all__ 自定义导入

__all__ 是一个特殊的变量（列表），用于定义模块中对外公开的符号（函数、类、变量等）。当其他模块使用 from module import * 语句导入模块时，只有在 __all__ 列表中列出的符号才会被导入。

在 Python 中，模块是用于组织代码的一种方式，可以将相关的函数、类和变量放在一个独立的文件中。当其他模块想要使用该模块提供的功能时，可以通过 import 语句导入模块。

然而，使用 from module import * 形式导入模块可能不是一种好的实践，因为它导入了模块中的所有符号，包括以单下划线 _ 开头的私有符号。在大型项目中，可能会导致命名冲突和代码可读性降低的问题。

为了控制模块中导入的符号，可以在模块中定义 __all__ 变量。该变量是一个包含字符串的列表，这些字符串是模块中对外公开的符号名称。

以下是一个示例模块 my_module.py，定义了 __all__ 变量：

# my_module.py

def public_func():
    pass

def _private_func():
    pass

class PublicClass:
    pass

class _PrivateClass:
    pass

__all__ = ['public_func', 'PublicClass']

在上述示例中，__all__ 列表中包含了 public_func 和 PublicClass 两个公开的符号。这意味着，当其他模块使用 from my_module import * 导入 my_module 时，只有这两个符号会被导入。

注意，Python 解释器并不强制执行 __all__ 的限制。它主要是一种文档约定，用于指示模块的公开接口。如果其他开发人员遵守这一约定，应该只使用 __all__ 中列出的符号。

如果希望限制导入的符号，最好是使用显式的导入语句来指定要导入的符号，例如 from my_module import public_func, PublicClass。这样可以更清晰地控制导入的符号，并提高代码的可读性和可维护性。