### Python 模块中 `__name__` 和 `__all__` 的作用与区别 #### 1. `__name__` 的作用及用法 在 Python 中，`__name__` 是一个内置的特殊变量，它的值取决于模块是如何被执行的。 - 如果模块作为主程序运行，则 `__name__` 的值为 `'__main__'`[^4]。 - 如果模块被其他模块导入，则 `__name__` 的值为模块的名字。 这种机制通常用于区分模块是直接运行还是被导入的情况。通过判断 `if __name__ == '__main__':`，可以实现只在模块直接运行时才执行某些代码（如测试代码），而这些代码不会在模块被导入时执行。 示例代码如下： ```python def function_a(): print("Function A") if __name__ == "__main__": function_a() # 此部分仅在模块直接运行时执行 ``` --- #### 2. `__all__` 的作用及用法 `__all__` 是一个特殊的列表变量，用于显式声明模块对外公开的接口。当使用 `from module import *` 导入模块时，只有 `__all__` 列表中列出的名称会被导入[^2]。如果没有定义 `__all__`，则默认会导入模块中所有不以下划线开头的名称。 以下是其主要用途： - 控制模块的公共接口，避免暴露不必要的内部实现细节[^3]。 - 防止命名冲突和命名空间污染[^5]。 示例代码如下： ```python # test_module.py __all__ = ["function_b"] def function_a(): pass def function_b(): print("This is a public function.") def _private_function(): print("This should not be imported.") ``` 如果另一个脚本使用 `from test_module import *`，只会导入 `function_b` 而忽略 `_private_function` 和 `function_a`。 --- #### 3. `__name__` 和 `__all__` 的区别 | 特性 | `__name__` | `__all__` | |--------------------|-----------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------| | **功能** | 用于识别模块是以主程序方式运行还是被导入 | 显式声明模块的公共接口 | | **数据类型** | 字符串 | 列表 | | **适用场景** | 区分模块是否独立运行 | 控制 `from ... import *` 导入的内容 | | **影响范围** | 影响整个模块的行为 | 仅影响特定导入语句 (`from ... import *`) | --- ### 总结 - 使用 `__name__` 可以控制模块内的代码是否在导入时不被意外执行。 - 定义 `__all__` 可以精确管理模块的公共接口，从而提高代码的安全性和可维护性。 ---