介绍
在 Python 中，__main__ 是顶级代码执行时所在的命名空间（scope）的名称。当一个 Python 文件直接从命令行运行时，其特殊的内置变量 __name__ 会被设置为字符串 "__main__"。然而，当该文件作为模块导入到另一个脚本中时，其 __name__ 会被设置为其自身的文件名。
这种行为催生了一种常见且强大的惯用法：仅当文件作为主程序运行时，才执行特定的代码块。这通过 if __name__ == "__main__": 语句来实现。
在这个 Lab 中，你将学习如何使用这个条件块，使你的 Python 文件更具通用性，使其既能作为独立的脚本运行，也能作为可重用的模块使用。
理解主命名空间
在这一步，你将学习 __main__ 作用域是什么，并了解一个模块的 __name__ 变量如何根据其执行方式而变化。
首先，让我们创建一个简单的 Python 模块并检查其 __name__ 变量。
注意： 如果你不熟悉如何使用 WebIDE (类似 VS Code)，请先通过 这个实验 学习。
- 从左侧的文件浏览器中打开文件
my_module.py。 - 将以下代码添加到
my_module.py中。这段代码定义了一个函数，然后打印__name__变量的值。
## my_module.py
def greet(name):
print(f"Hello, {name}!")
print(f"The __name__ of my_module.py is: {__name__}")
## 此代码块检查脚本是否被直接运行
if __name__ == "__main__":
print("my_module.py is being run directly.")
greet("World")
现在，让我们直接运行此文件作为脚本。打开终端并执行以下命令：
python3 my_module.py
你将看到以下输出。请注意，__name__ 等于 "__main__"，因此 if 块内的代码被执行了。
The __name__ of my_module.py is: __main__
my_module.py is being run directly.
Hello, World!
接下来，让我们看看当我们将 my_module.py 导入到另一个脚本中时会发生什么。
- 打开文件
main.py。 - 添加以下代码，它导入了
my_module并调用了其greet函数。
## main.py
import my_module
print("Running main.py")
my_module.greet("LabEx")
现在，从终端运行 main.py：
python3 main.py
仔细观察输出：
The __name__ of my_module.py is: my_module
Running main.py
Hello, LabEx!
当 main.py 导入 my_module.py 时，Python 解释器会执行 my_module.py 中的代码。这一次，它的 __name__ 变量被设置为 "my_module"（即模块文件的名称）。由于 __name__ 不等于 "__main__"，if __name__ == "__main__": 块内的代码不会被执行。这演示了如何将旨在直接执行的代码与模块的可重用部分分离开来。
主检查的优势
在这一步中，你将探索使用 if __name__ == "__main__": 检查的关键优势。这个简单的条件语句是编写模块化和可重用 Python 代码的基础。
主要优势包括：
- **双重功能 (Dual Functionality)**：它允许一个 Python 文件既可以作为可导入的模块，也可以作为可直接运行的独立程序。
- **代码封装 (Code Encapsulation)**：它确保测试代码、命令行入口点或示例用法片段仅在文件被直接执行时运行，而在被其他模块导入时不会运行。这可以防止意外的副作用。
- **模块化和可重用性 (Modularity and Reusability)**：通过将脚本级别的逻辑与核心功能分离，你可以使函数更具可重用性，并使代码更易于测试和维护。
让我们通过一个实际的例子来说明这一点。想象你正在创建一个带有简单功能的工具模块。
- 从左侧的文件浏览器中打开文件
calculator.py。 - 将以下代码添加到
calculator.py中。add函数是可重用的，而if块内的代码则作为简单的测试或演示。
## calculator.py
def add(a, b):
"""This function adds two numbers."""
return a + b
## This block will only execute when calculator.py is run directly.
## It's a good place for tests or a simple command-line interface.
if __name__ == "__main__":
print("Running calculator.py as a standalone script for testing.")
result = add(3, 5)
print(f"A test run of add(3, 5) results in: {result}")
直接运行此文件以查看测试代码的实际运行情况：
python3 calculator.py
输出显示测试块已执行：
Running calculator.py as a standalone script for testing.
A test run of add(3, 5) results in: 8
现在，让我们在主应用中重用 add 函数。
- 修改
main.py以从calculator.py导入并使用add函数。
## main.py
from calculator import add
print("Using the 'add' function from the calculator module.")
sum_result = add(10, 20)
print(f"The result of add(10, 20) is: {sum_result}")
- 从终端运行
main.py：
python3 main.py
你将得到以下输出：
Using the 'add' function from the calculator module.
The result of add(10, 20) is: 30
如你所见，来自 calculator.py 的测试代码没有执行。我们成功导入并使用了 add 函数，而没有运行特定于脚本的逻辑，这证明了 if __name__ == "__main__": 检查在创建干净、可重用的模块方面的强大作用。
总结
在这个实验中，你学习了 Python 中的 __main__ 命名空间以及 if __name__ == "__main__": 条件块的重要性。
你已经了解到：
- 当 Python 模块被直接运行时，其
__name__变量被设置为"__main__"。 - 当模块被导入时，其
__name__被设置为模块的文件名。 if __name__ == "__main__":检查允许你编写仅在文件作为独立脚本运行时才执行的代码。
这个强大的特性是编写模块化和可重用 Python 代码的关键，它使得你的文件既可以作为可执行程序，也可以作为可导入的库。通过将特定于脚本的逻辑与核心功能分离，你可以创建更清晰、更易于维护和更专业的 Python 应用。
