subprocess.run的返回值

### Python `subprocess.run` 的返回值

在 Python 中，`subprocess.run` 函数执行给定命令并等待其完成。该函数总是返回一个 `CompletedProcess` 实例[^1]。

#### `CompletedProcess` 属性

- **args**: 提供传入的参数列表或字符串。
- **returncode**: 整数形式表示子进程退出状态码；如果尚未结束则可能为 `None`.
- **stdout**: 子进程中标准输出的数据，默认情况下只有当调用时设置了 `stdout=PIPE` 才会捕获此数据.
- **stderr**: 类似于 `stdout`, 不过是从标准错误流读取.

下面是一个简单的例子来展示如何获取这些属性：

import subprocess

result = subprocess.run(
    ["echo", "Hello World"], 
    capture_output=True, 
    text=True
)

print(f"Command executed: {result.args}")
print(f"Exit code: {result.returncode}")
print(f"Standard output: {result.stdout.strip()}")
print(f"Standard error: {result.stderr.strip() if result.stderr else 'No errors'}")

上述代码片段展示了如何通过访问 `CompletedProcess` 对象的不同字段来查看命令的结果以及任何产生的输出或错误消息.