subprocess.run() 返回码总是0的根本原因是未显式指定shell=true，导致系统绕过shell解析器直接执行无shebang的脚本，默认返回0；应确保脚本有有效shebang或显式启用shell=true，并避免shlex.split与shell=true混用、check=true未捕获异常及脚本内trap/后台任务干扰退出码。
subprocess.run() 为什么返回码总是 0？
常见现象是：Shell 脚本里写了 exit 1，但 Python 用 subprocess.run() 调用后，result.returncode 却是 0。根本原因是没显式指定 shell=True，导致 Python 绕过 shell 解析器，直接把脚本路径当可执行文件调用——这时系统尝试用 execve() 直接运行脚本，而没有 shebang（如 #!/bin/bash）的脚本会被当作普通文本执行，失败后默认返回 0。
实操建议：
- 确认脚本第一行有有效 shebang，比如
#!/bin/bash或#!/usr/bin/env bash - 显式传入
shell=True，让 Python 启动 shell 进程来解释脚本：subprocess.run(["./script.sh"], shell=True) - 如果脚本路径含空格或需变量展开，
shell=True是必须的；否则建议用shell=False（更安全），并确保脚本能被直接执行（chmod +x + shebang）
shlex.split() 和字符串传参混用导致 returncode 失效
错误写法：subprocess.run("bash -c './script.sh'", shell=True) 看似合理，但实际会启动 bash，再由它去执行 ./script.sh——此时 ./script.sh 的退出码不会自动透传给外层 bash 进程，除非你在脚本末尾显式加 exit $?。
更稳妥的做法是避免嵌套 shell：
- 直接调用脚本：
subprocess.run(["./script.sh"], shell=False, check=False)（前提：脚本可执行且有 shebang） - 需要动态参数时，用
shlex.split()拆分命令字符串，再配shell=False：subprocess.run(shlex.split("bash -c 'exit 1'")) - 不要用
shell=True+ 手动拼接字符串，容易被注入，也干扰 exit code 传递
忽略 check=True 导致异常吞掉真实 returncode
设了 check=True 但没捕获 subprocess.CalledProcessError，Python 就会直接抛异常中断流程，你根本拿不到 returncode 字段。很多人以为“没报错就是成功”，其实脚本已退出非 0，只是异常没被处理。
正确姿势：
- 想主动判断状态，就别用
check=True，改用check=False，然后检查result.returncode - 真要用
check=True，必须包在try/except subprocess.CalledProcessError as e:里，此时e.returncode才是脚本的真实退出码 -
check=True不等于“确保成功”，它只是“失败时抛异常”，不抛异常 ≠ 返回码为 0
Shell 脚本里 trap、子 shell 或后台任务干扰 exit code
脚本里用了 set -e 但某条命令失败后被 trap 捕获并忽略，或者用了 (...)& 启动后台进程，又没等它结束，主 shell 可能提前退出并返回 0——Python 拿到的就是这个提前返回的 0。
排查重点：
- 去掉所有
trap，或确保 trap 里显式调用exit并传入原始错误码 - 避免无等待的后台任务：
command &→ 改成command或显式wait - 测试脚本本身：终端里直接运行
./script.sh; echo $?，确认返回码符合预期，再进 Python
$? 输出是你想要的数字。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
