Python 中 if __name__ == '__main__' 的含义与用法
理解 Python 的程序入口
在许多编程语言中，程序都有一个明确的入口点，比如 C/C++ 的 main 函数，或者 Java/C# 中的 Main 方法。然而 Python 作为脚本语言，并不会在运行前编译成二进制文件，而是逐行解释执行。这意味着 Python 脚本的执行从第一行开始，没有强制规定的统一入口。
一个 Python 文件既能被直接执行，也能作为模块被导入其他脚本。无论是哪种情况，文件的顶层代码（即不在函数或类内部的代码）都会被运行。但在导入时，我们往往不希望执行某些特定代码，比如测试代码。
问题示例
假设我们有一个 const.py 文件，定义了一些常量和一个测试函数：
PI = 3.14
def main():
print("PI:", PI)
main()
直接运行 const.py 会输出 PI: 3.14。
现在，我们创建 area.py 来计算圆的面积，需要导入 const.py 中的 PI：
from const import PI
def calc_round_area(radius):
return PI * (radius ** 2)
def main():
print("round area:", calc_round_area(2))
main()
运行 area.py 后，我们会看到：
PI: 3.14
round area: 12.56
这里，const.py 中的 main 函数也被执行了，这显然不是我们想要的。为了解决这个问题，可以使用 if __name__ == '__main__'：
PI = 3.14
def main():
print("PI:", PI)
if __name__ == "__main__":
main()
修改后，运行 area.py 只会输出 round area: 12.56，而直接运行 const.py 依然会输出 PI: 3.14。
这段代码相当于为 Python 提供了一个"模拟入口"。它并非语言强制，而是一种广泛使用的编码习惯，用于区分文件是直接执行还是被导入。
__name__ 变量的作用
__name__ 是 Python 的内置变量，表示当前模块的名称。它还能反映模块在包中的结构。例如，我们有包结构如下：
a/
├── b/
│ ├── c.py
│ └── __init__.py
└── __init__.py
如果每个 .py 文件都包含 print(__name__)，那么执行 python -c "import a.b.c" 会输出：
a
a.b
a.b.c
这说明 __name__ 清晰地显示出模块在包中的层次，也就是 import 语句中使用的名字。
当模块被直接运行时，它没有包层级，此时 __name__ 被设置为 __main__。例如直接运行 python a/b/c.py，输出会是：
__main__
因此，if __name__ == '__main__' 的核心逻辑是：如果模块直接被运行，则执行该代码块；如果被导入，则不执行。
__main__.py 文件与 python -m 参数
这个问题还涉及到 __main__.py 和 Python 的 -m 参数。它们用于将包或模块作为脚本运行。
python xxx.py 与 python -m xxx.py 的区别
直接运行和以模块方式运行的行为有所不同。假设 run.py 内容如下：
import sys
print(sys.path)
直接运行 python run.py 的输出（简化）：
['/path/to/script/directory', ...]
而以模块方式运行 python -m run.py 的输出：
['', ...]
/usr/bin/python: No module named run.py
区别在于：直接运行会将脚本所在目录加入 sys.path；而 -m 参数则将当前工作目录加入 sys.path，并且会先对模块执行 import 操作，然后再尝试运行。上面的错误是因为 run.py 并不是一个有效的模块名（应该用 python -m run）。
__main__.py 的作用
考虑以下包结构：
package/
├── __init__.py
└── __main__.py
__init__.py 内容：
import sys
print("__init__")
print(sys.path)
__main__.py 内容：
import sys
print("__main__")
print(sys.path)
使用 python -m package 运行会输出：
__init__
['', ...]
__main__
['', ...]
使用 python package 运行则会输出：
__main__
['package', ...]
总结如下：
- 使用
-m参数时，当前工作目录会被加入sys.path；不使用时，则加入脚本所在目录。 - 使用
-m时，Python 会先导入模块或包，再执行。 __main__.py是包或目录的入口程序，无论使用python package还是python -m package，它都会被执行。
希望本文能帮助您深入理解 if __name__ == '__main__' 的用法及其背后的机制。Python 虽然简洁，却蕴含许多精巧的设计，掌握这些惯用法有助于写出更加优雅和实用的代码。
