怎样在Python中使用subprocess模块捕获子进程错误-Python教程-PHP中文网

subprocess.run() 默认不抛异常，错误码被静默吞掉；必须显式设置 check=true 才在非零退出码时抛出 calledprocesserror，否则需手动检查 result.returncode。

怎样在python中使用subprocess模块捕获子进程错误

subprocess.run() 默认不抛异常，错误码被静默吞掉

很多人调用 subprocess.run() 后发现命令执行失败（比如 ls /nonexistent），但 Python 没报错、returncode 也不为 0，程序照常往下走——这是因为默认情况下它只返回 CompletedProcess 对象，错误码不会触发异常。

想让错误“露出来”，必须显式设置 check=True：

import subprocess
try:
    subprocess.run(["ls", "/nonexistent"], check=True, capture_output=True, text=True)
except subprocess.CalledProcessError as e:
    print(f"命令失败，退出码 {e.returncode}")
    print(f"stderr: {e.stderr.strip()}")

check=True 是关键开关：遇到非零退出码立即抛 CalledProcessError
capture_output=True 和 text=True 让 e.stdout/e.stderr 可直接当字符串用，否则是 bytes
不加 check=True 时，得手动检查 result.returncode != 0 再处理，容易漏

stderr 被重定向后，CalledProcessError.stderr 才有内容

即使开了 check=True，如果没捕获 stderr，异常对象里的 stderr 字段仍是 None，打印出来就是空的。这不是 bug，是设计：subprocess 默认把子进程 stderr 接到父进程 stderr（也就是终端），不经过 Python 管道。

要拿到错误输出，必须主动接管：

用 capture_output=True（等价于 stdout=subprocess.PIPE, stderr=subprocess.PIPE）
或显式写 stderr=subprocess.PIPE（如果只要 stderr，不需要 stdout）
若用了 stderr=subprocess.STDOUT，错误会混进 stdout，e.stderr 仍为 None

常见误操作：subprocess.run(cmd, check=True) 直接抛异常，但 e.stderr 是 None，以为没输出，其实是没捕获。

Shadows Python Sensei

Python 最佳实践助手——代码规范、设计模式、性能优化、测试与类型注解。适用于编写或审查 Python 代码。

下载

shell=True 时错误信息可能更模糊，尽量避免

当命令含管道、重定向或 shell 特性（如 ls *.py | wc -l）时，有人会加 shell=True。但这会让错误来源变难定位：

退出码属于 shell 进程本身，不是原始命令；比如 cat nonexistent.txt | grep foo 失败，可能是 cat 错也可能是 grep 错，但你只看到 shell 的 returncode
CalledProcessError.stderr 通常为空，因为 shell 把错误打到终端了，没走 PIPE
安全风险：变量拼接命令时易遭 shell 注入（f"ls {user_input}"）

建议拆成多个 subprocess.run() 调用，或用 shlex.split() 解析命令再传列表，绕过 shell=True。

超时和编码问题常导致“捕获失败”假象

看起来没捕获到错误，有时其实是卡在别的地方：

timeout 参数设太小，命令还没跑完就抛 TimeoutExpired 异常，这不是 CalledProcessError，得单独捕获
text=False（默认）时，e.stdout/e.stderr 是 bytes，直接 print(e.stderr) 可能显示乱码或报 UnicodeDecodeError；务必配 text=True 或手动指定 encoding="utf-8"
某些命令（如 git）在管道环境下会禁用颜色/进度条，输出格式变化，别依赖固定字符串匹配