Python CLI脚本顶部添加__main__防护代码是否为不良实践？

这绝对是不值得提倡的写法，主要问题集中在这几个方面：

• 彻底断绝了代码复用的可能：如果未来你自己或者其他开发者想从这个脚本里导入某个有用的工具函数、类或者逻辑片段，只要一导入就会触发sys.exit(0)直接退出程序，完全没法复用任何内容。很多CLI脚本里其实藏着可复用的逻辑，这么写等于把这些潜力全部浪费了。

• 让调试和测试变得异常困难：单元测试需要导入模块中的代码来单独验证功能，但你的写法会导致测试框架刚导入模块就直接退出，根本没法对单独的函数或者逻辑做测试。如果后面脚本出了问题，定位bug会非常麻烦。

• 代码结构会越来越混乱：把所有逻辑都堆在全局作用域里，随着脚本功能增加，变量污染、逻辑耦合的问题会越来越严重。比如全局变量被意外修改、不同功能的代码混在一起，后期维护和修改会让你头疼不已。

• 违背Python社区的惯用法：if __name__ == '__main__'是Python开发者公认的脚本入口写法，所有人看到这行代码就知道这是程序的启动点。而你的反向写法不仅不符合约定，还会让其他开发者困惑，增加了代码的理解成本。

更好的替代方案 #

其实你想避免的那种“把代码放进函数+入口调用”的写法，才是Python CLI脚本的标准实践，虽然多写几行，但好处太多：

比如把核心逻辑封装进main函数，然后在脚本底部添加入口判断：

def main():
    # 把你原来写的所有代码都放到这里
    print("执行CLI逻辑...")

if __name__ == '__main__':
    main()

这么做的优势：

• 模块可以被安全导入，里面的函数、类都能被其他代码复用
• 方便编写单元测试，直接导入main函数或者其他子函数单独测试
• 代码结构清晰，逻辑划分明确，后期扩展和维护更轻松
• 符合Python社区的通用规范，可读性更高，其他开发者接手时毫无障碍

哪怕你的脚本非常短小，这种写法的额外成本几乎可以忽略，但能给你带来长远的可维护性，绝对是值得的。

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