### Python 中 `__all__` 的含义和用法 在 Python 中，`__all__` 是一个特殊变量，用于显式定义模块的公共接口。当从模块中使用 `from module import *` 语法时，`__all__` 决定了哪些名称可以被导入[^1]。如果没有定义 `__all__`，则所有不以下划线 `_` 开头的名称将默认被导入。 #### 作用 `__all__` 的主要作用是控制模块的公共接口，限制哪些属性、函数或类可以通过 `from module import *` 导入。这有助于避免命名冲突，提高代码的可读性和安全性[^4]。 #### 使用场景 以下是 `__all__` 的典型使用场景： 1. **控制模块的公共接口** 当模块中有许多内部实现细节时，可以通过 `__all__` 来明确指定哪些内容对外可见。例如： ```python # my_module.py def public_function(): pass def _private_function(): pass __all__ = ['public_function'] ``` 在这种情况下，即使 `_private_function` 存在于模块中，它也不会通过 `from my_module import *` 被导入[^4]。 2. **避免命名冲突** 如果模块中有多个同名的变量或函数，`__all__` 可以帮助开发者明确指定哪些名称应该被导出。例如： ```python # my_module.py def add(a, b): return a + b def subtract(a, b): return a - b __all__ = ['add'] ``` 在此例中，只有 `add` 函数会被导入，而 `subtract` 不会被包含在内[^4]。 3. **提高代码可读性** 显式列出模块的公共接口可以让其他开发者更清楚地了解模块的功能范围。例如： ```python # my_module.py class MyClass: pass def helper_function(): pass __all__ = ['MyClass'] ``` 这样一来，用户可以直接看到 `MyClass` 是模块的主要功能，而 `helper_function` 则是内部实现细节[^1]。 #### 示例代码 以下是一个完整的示例，展示如何使用 `__all__` 控制模块的公共接口： ```python # my_module.py def function_a(): return "This is function A" def function_b(): return "This is function B" def _private_function(): return "This is a private function" __all__ = ['function_a', 'function_b'] # another_module.py from my_module import * print(function_a()) # 输出: This is function A print(function_b()) # 输出: This is function B # print(_private_function()) # 报错: _private_function 未定义 ``` #### 注意事项 - 如果没有定义 `__all__`，则默认会导入所有不以下划线 `_` 开头的名称。 - `__all__` 只影响 `from module import *` 的行为，不会影响通过 `import module` 或 `from module import name` 的方式导入的内容[^4]。 ---