`__name__` 是 Python 中每个模块（即每个 `.py` 文件）**自动拥有的内置属性**，其值由模块**被加载/执行的方式**决定。它不是常量，而是运行时动态确定的字符串，对理解模块行为、控制执行入口（如 `if __name__ == "__main__":`）至关重要。 以下是 `__name__` **所有可能的取值及其产生场景的完整说明**（覆盖所有官方和常见实践情况）： --- ### ✅ 1. `"__main__"` —— **最核心、最常用的情况** - **触发条件**：该 `.py` 文件**被直接作为脚本运行** ```bash python script.py python -m script # 注意：仅当 script.py 在 sys.path 中且无同名包时成立（见下文） ``` - **含义**：Python 解释器将此文件视为“主程序入口”，因此赋予特殊名称 `"__main__"`； - **典型用途**： ```python if __name__ == "__main__": main() # 仅在此场景下调用主逻辑 ``` > ⚠️ 注意：`python -m module_name` 的行为取决于 `module_name` 是否为**包（package）**： > - 若 `module_name` 是一个**普通模块**（如 `foo.py`），且 `foo.py` 在当前目录或 `PYTHONPATH` 中 → `__name__` 为 `"__main__"`； > - 若 `module_name` 是一个**包**（含 `__init__.py`），则 `python -m package_name` 会执行 `package_name.__main__` 模块（如果存在），此时该 `__main__.py` 的 `__name__` 才是 `"__main__"`，而 `package_name.__init__` 的 `__name__` 是 `"package_name"`。 --- ### ✅ 2. 模块名（字符串）—— **被其他模块导入时** - **触发条件**：该 `.py` 文件被 `import` 或 `from ... import ...` 加载 ```python # 在 other.py 中： import my_module # → my_module.__name__ == "my_module" from utils import helper # → utils/__init__.py.__name__ == "utils" ``` - **取值规则**： - 对于顶层模块（如 `math.py`, `requests.py`）：`__name__` = 文件名（不含 `.py`），如 `"math"`, `"requests"`； - 对于子模块（如 `package/submodule.py`）：`__name__` = **完整点分路径**，如 `"package.submodule"`； - 对于包（含 `__init__.py` 的目录）：`__name__` = 包名（如 `"numpy"`, `"django"`）； - 对于 `__main__.py`（包内专用入口）：当通过 `python -m package` 运行时，`package/__main__.py` 的 `__name__` 是 `"__main__"`，但 `package.__init__.py` 的 `__name__` 仍是 `"package"`。 ✅ 示例验证： ```python # file: a/b/c.py print(f"In c.py, __name__ = {__name__}") ``` ```python # file: a/__init__.py print(f"In a/__init__.py, __name__ = {__name__}") ``` ```python # file: main.py import a.b.c # 输出： # In a/__init__.py, __name__ = a # In c.py, __name__ = a.b.c ``` --- ### ✅ 3. `"__mp_main__"` —— **多进程（multiprocessing）中主模块的特殊值（Windows/macOS）** - **触发条件**：在 Windows 或 macOS 上使用 `multiprocessing` 启动新进程时，子进程会重新导入主模块； - **原因**：为避免子进程重复执行主逻辑（如意外启动多个 GUI 窗口），Python 将子进程中的主模块 `__name__` 设为 `"__mp_main__"`（而非 `"__main__"`）； - **意义**：确保 `if __name__ == "__main__":` **在子进程中不成立**，从而防止递归创建进程； - ✅ 这是 Python 多进程安全机制的关键设计。 > 📌 注：Linux 默认使用 `fork`，子进程继承父进程状态，`__name__` 仍为 `"__main__"`，但通常仍需 `if __name__ == "__main__":` 防御（尤其跨平台代码）。 --- ### ✅ 4. `"__console__"` —— **交互式解释器环境（IPython/Jupyter 特有）** - **触发条件**：在 IPython、Jupyter Notebook 或某些 IDE 的交互式终端中执行代码； - **说明**：这不是 CPython 标准行为，而是 IPython 内核的扩展约定； - **用途**：可用来区分脚本执行与交互式探索（如动态启用调试日志）； - ✅ 示例： ```python if __name__ == "__console__": print("正在 Jupyter 中运行") ``` --- ### ✅ 5. 其他极少见但合法的值（高级/特殊场景） | 值 | 触发场景 | 说明 | |----|-----------|------| | `"__builtin__"`（Python 2） / `"builtins"`（Python 3） | 访问 `builtins` 模块本身 | `import builtins; print(builtins.__name__)` → `"builtins"` | | `"<frozen ...>"` | 冻结模块（frozen modules，如部分嵌入式 Python 或 PyInstaller 打包后） | 如 `"<frozen importlib._bootstrap>"`，表示该模块由 C 代码预编译加载 | | `""`（空字符串） | **极其罕见**：手动修改 `__name__`（不推荐！） | `sys.modules[__name__] = type(sys)('fake'); sys.modules['fake'].__name__ = ''` —— 属于 hack 行为，破坏模块系统 | > ❌ **非法值**：`None`、数字、列表等非字符串类型 —— `__name__` **必须是字符串**，否则会引发 `TypeError`（CPython 强制校验）。 --- ### 🔍 快速验证 `__name__` 的方法（实操） 在任意 `.py` 文件中添加： ```python print(f"当前模块 __name__ = {repr(__name__)}") print(f"当前文件路径 = {__file__}") import sys print(f"是否为主模块？{__name__ == '__main__'}") ``` 然后分别测试： - `python script.py` → `"__main__"` - `python -c "import script"` → `"script"` - （Windows）`python -c "import multiprocessing as mp; mp.Process(target=lambda: None).start()"` → 子进程内为 `"__mp_main__"` --- ### 💡 总结：`__name__` 的本质 > `__name__` 是 Python **模块加载系统的“身份标签”**： > - 它告诉解释器：“我是谁？”（模块标识） > - 它告诉开发者：“我该如何被使用？”（直接运行？被导入？被 fork？） > - 它是实现**模块复用性、安全性、可测试性**的底层基石。 ---