Python 脚本如何设置退出码

Python脚本的退出码是连接程序逻辑与外部环境（如Shell、CI工具、Kubernetes）的关键信号，但正确设置远不止调用`sys.exit()`那么简单：必须理解`sys.exit(0)`代表成功、非零值需有明确语义（如`2`表示配置缺失），避免误用`os._exit()`跳过清理，杜绝依赖`main()`返回值的常见误解，并始终通过`echo $?`在Shell中验证实效；真正难点在于建立清晰、一致、可维护的退出码规范——用命名常量替代魔数，让每个错误码都可读、可追溯、可自动化响应，从而把“程序是否运行完”升级为“程序为何这样结束”。

sys.exit() 是最直接的方式

Python 脚本的退出码由 sys.exit() 的参数决定，它会立即终止程序并把整数参数作为进程退出状态返回给 shell。不传参默认是 0（成功），传非零值（如 1、2）通常表示失败。

• sys.exit(0) 表示正常结束，shell 中 $? 会得到 0
• sys.exit(1) 是最常用的错误码，但语义需自行约定（比如参数错误、IO 失败等）
• 传字符串（如 sys.exit("error")）会触发 SystemExit 异常并打印该字符串到 stderr，退出码仍为 1
• 避免用 os._exit()，它绕过清理逻辑（如 atexit 注册函数、文件缓冲区刷新），仅在 fork 后子进程里必要时使用

异常未捕获时也会产生退出码

未被 try/except 捕获的异常会让 Python 解释器打印 traceback 并以退出码 1 结束进程。这看似“自动”，但实际不可控——你无法区分是 ValueError 还是 FileNotFoundError 导致的失败。

• 显式捕获异常后调用 sys.exit(2) 或其他有意义的码，比放任崩溃更利于调试和自动化调用
• 某些 CI 工具或 shell 脚本依赖特定退出码做分支判断（比如 126 表示命令不可执行，127 表示命令未找到），随意抛异常会丢失这个信号
• 自定义异常类本身不改变退出行为，仍需配合 sys.exit() 才能设定非 1 的码

main() 函数返回值不会变成退出码

这是常见误解：写一个 def main(): return 42 然后调用它，脚本依然以 0 退出。Python 不像 C，main() 的返回值只是普通函数返回值，对进程状态无影响。

• 必须显式调用 sys.exit()，或让异常传播到底层（但如前所述，不推荐）
• 常见模式是：if __name__ == "__main__": sys.exit(main())，此时 main() 可以返回整数退出码，再由 sys.exit() 透出
• 注意：如果 main() 返回 None，sys.exit(None) 等价于 sys.exit(0)

Shell 层面验证退出码是否生效

写完脚本别只靠 print 看输出，得真正在 shell 里检查 $?。尤其当脚本被管道、后台运行或集成进 Makefile 时，退出码才是唯一可靠的信号。

• 运行后立刻执行 echo $?，确认是否得到预期数字
• 用 set -e 的 shell 脚本中，任何非零退出都会中断执行，这时错设退出码可能导致误中断
• 某些容器环境（如 Kubernetes initContainer）会严格检查退出码 0/非0 来判定就绪，返回错码可能让服务卡在启动阶段

真正难的不是怎么设退出码，而是统一设计一套内部可读、外部可解析的码表，并在所有异常路径里一致应用。没人会记住 7 和 13 分别代表什么，但文档里写清楚 2 = missing config file，再配个 EXIT_MISSING_CONFIG = 2 常量，就少很多半夜查日志的时刻。

好了，本文到此结束，带大家了解了《Python 脚本如何设置退出码》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！