subprocess.check_output 默认吞掉 stderr 且不暴露，仅当退出码非零才抛异常；需改用 subprocess.run(..., capture_output=true, check=true) 分别获取 stdout 和 stderr。
subprocess.check_output 会吞掉 stderr 吗
会，而且默认情况下完全不暴露 stderr。调用 subprocess.check_output 时，如果子进程写入 stderr，它不会自动合并到返回值里，也不会抛出异常——除非进程本身退出码非零（此时才触发 CalledProcessError）。但很多命令（比如 gcc、curl）即使出错也仍走 stderr 输出错误信息，而退出码可能还是 0，这就导致你“以为成功”，实际却漏掉了关键报错。
捕获 stderr 必须显式传 capture_output=True 和 stderr=PIPE
check_output 的签名里没有 stderr 参数，它只控制 stdout；真正要拿到 stderr，得靠 subprocess.run 或者手动组合参数。但如果你坚持用 check_output，唯一办法是降级使用底层接口：
- 传
stderr=subprocess.STDOUT：把stderr重定向进stdout流，这样返回的 bytes 就包含两者混合内容（顺序取决于子进程实际写入时机） - 或改用
subprocess.run(..., capture_output=True, check=True)：这是更现代、更清晰的做法，返回对象的.stdout和.stderr属性可分别访问
示例对比：
# ❌ 错误：stderr 被丢弃，且不报错
try:
out = subprocess.check_output(["ls", "nonexistent"])
except subprocess.CalledProcessError as e:
print("只在 exit code != 0 时触发，但很多错误不改 exit code")
<h1>✅ 正确：显式捕获 stderr（推荐用 run）</h1><p>result = subprocess.run(["ls", "nonexistent"], capture_output=True, check=False)
print(result.stdout) # b''
print(result.stderr) # b"ls: cannot access 'nonexistent': No such file or directory\n"
if result.returncode != 0:
raise subprocess.CalledProcessError(result.returncode, result.args, result.stdout, result.stderr)
</p>
check_output + stderr=STDOUT 的典型误用场景
这个组合看似能“一并拿到所有输出”，但实际埋了几个坑：
- 输出混杂：
stdout和stderr写入缓冲策略不同，混合后难以区分哪段是错误、哪段是正常结果 - 编码风险：如果子进程
stderr是 UTF-8 错误提示，而stdout是二进制数据（比如dd），解码会失败 - 调试困难：日志里看到一堆乱序输出，没法快速定位错误源头
所以除非你明确需要“把 stderr 当 stdout 处理”（例如统一重定向到日志文件），否则别用 stderr=subprocess.STDOUT 配合 check_output。
替代方案：用 run + check=True 更可控
subprocess.run 是 Python 3.5+ 推荐的统一入口，配合 check=True 行为几乎等价于 check_output，但多了 stderr 控制权：
-
capture_output=True自动设置stdout=PIPE和stderr=PIPE -
check=True在returncode != 0时自动抛CalledProcessError，且该异常对象带.stdout和.stderr属性 - 还能加
text=True直接返回 str 而非 bytes，避免手动 decode
示例：
try:
result = subprocess.run(
["python", "-c", "import sys; print('ok'); print('error', file=sys.stderr)"],
capture_output=True,
text=True,
check=True
)
print("stdout:", repr(result.stdout)) # 'ok\n'
print("stderr:", repr(result.stderr)) # 'error\n'
except subprocess.CalledProcessError as e:
print("失败，stdout:", repr(e.stdout))
print("失败，stderr:", repr(e.stderr))
真正难处理的不是怎么捕获，而是判断“哪些 stderr 算错误”——有些命令（如 ffmpeg）把进度日志打到 stderr，但你不该因此中断流程。这时候得结合退出码、关键词匹配或自定义解析逻辑，不能只看有没有 stderr 输出。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
