解释Python主脚本仅在模块直接执行时运行的规则含义

规则核心含义 #

这个要求是Python模块的标准双场景适配规则：同一个.py文件需要同时支持两种使用方式，且执行逻辑严格隔离：

• 作为独立脚本直接运行时：自动执行你写的自动化测试逻辑，最终打印测试通过、失败的总数量
• 作为模块被其他文件通过import语句导入时：只对外暴露文件内定义的函数、类等能力，绝对不触发测试运行逻辑

底层判断逻辑 #

Python在运行任何.py文件时，都会给文件内置一个名为__name__的特殊变量，变量值根据运行场景自动赋值：

• 当你在终端通过python 你的作业文件名.py直接运行该文件时，__name__的值固定为"__main__"
• 当该文件被其他文件import时，__name__的值为文件本身的模块名（即不带.py后缀的文件名），不会等于"__main__"

可直接套用的实现方式 #

你只需要把所有自动化测试执行、结果统计打印的代码，全部放到if __name__ == "__main__":的判断代码块内部即可，参考最小实现示例：

# --------------------------
# 这部分代码无论直接运行还是被import都会正常加载，一般放你实现的业务功能、测试用例定义
def calculate_sum(a, b):
    return a + b

def run_all_tests():
    pass_count = 0
    fail_count = 0

    # 在这里按顺序写你的所有测试逻辑，统计通过/失败数
    if calculate_sum(1, 2) == 3:
        pass_count += 1
    else:
        fail_count += 1
    
    # 最终打印统计结果
    print(f"测试通过总数：{pass_count}，测试失败总数：{fail_count}")
# --------------------------

# 核心隔离判断
if __name__ == "__main__":
    # 只有直接运行当前文件时，才会执行块内的测试运行逻辑
    # 被其他文件import时，块内代码完全不会被触发
    run_all_tests()

正确性验证方法 #

写完代码后可以自行验证是否符合要求：

1. 直接运行你写的作业文件，能正常跑测试、输出通过/失败统计数
2. 新建一个空白的.py文件，在里面写import 你的作业文件名（不需要加.py后缀），运行这个新文件，不会触发任何测试执行、打印逻辑，就满足作业要求

教材里的示例本质就是用了这个内置特殊变量的判断逻辑，没有其他复杂语法，把测试执行的入口放到判断块里就不会出错。

内容的提问来源于stack exchange，提问作者Jason Renault