sys.exit() 是最直接的Python脚本退出方式,参数决定退出码:0表示成功,非零表示失败;传字符串会打印到stderr且退出码为1;需避免os._exit(),异常未捕获时默认退出码为1。

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 时,退出码才是唯一可靠的信号。
立即学习“Python免费学习笔记(深入)”;
- 运行后立刻执行
echo $?,确认是否得到预期数字 - 用
set -e的 shell 脚本中,任何非零退出都会中断执行,这时错设退出码可能导致误中断 - 某些容器环境(如 Kubernetes initContainer)会严格检查退出码 0/非0 来判定就绪,返回错码可能让服务卡在启动阶段
2 = missing config file,再配个 EXIT_MISSING_CONFIG = 2 常量,就少很多半夜查日志的时刻。









