理解Python中的if __name__ == '__main__'（新手入门必备的主程序入口控制技巧）

为什么需要 if __name__ == '__main__'？

假设你写了一个名为 utils.py 的文件，里面包含一些函数，同时也包含一些测试代码：

# utils.pydef greet(name):    return f"Hello, {name}!"# 测试代码print(greet("Alice"))

现在，如果你直接运行 python utils.py，会输出 Hello, Alice!，这没问题。

但如果你在另一个文件中导入这个模块：

# main.pyfrom utils import greetmessage = greet("Bob")print(message)

当你运行 python main.py 时，你会发现输出了两行：

Hello, Alice!Hello, Bob!

这是因为导入 utils.py 时，其中的 print(greet("Alice")) 也被执行了！这通常不是我们想要的——测试代码只应在直接运行该文件时执行。

正确使用 if __name__ == '__main__'

解决方法就是把测试代码或主程序逻辑放在 if __name__ == '__main__' 块中：

# utils.pydef greet(name):    return f"Hello, {name}!"if __name__ == '__main__':    # 只有在直接运行此文件时才会执行    print(greet("Alice"))

现在，当你运行 python main.py 时，只会输出 Hello, Bob!，而不会执行 utils.py 中的测试代码。只有当你直接运行 python utils.py 时，才会看到 Hello, Alice!。

实际应用场景

这种写法在以下场景非常有用：

• 编写可重用的模块，同时保留测试功能；
• 开发命令行工具，主逻辑放在 if __name__ == '__main__' 中；
• 在团队协作中避免导入时意外执行代码。

总结

if __name__ == '__main__' 是 Python主程序入口 的标准写法，它能有效控制代码的执行时机，是编写高质量、可维护 Python 代码的重要习惯。通过合理使用它，你可以实现 Python模块运行控制，让代码既可作为模块被导入，又可独立运行。

希望这篇 Python新手教程 能帮你彻底理解这一关键概念。快去试试吧！