### 使用 `subprocess.run()` 方法运行外部命令 `subprocess.run()` 是 Python 中用于执行外部命令的一个简单而强大的工具。它可以用来启动子进程，等待其完成，并返回结果对象。以下是关于该方法的一些重要特性和示例。 #### 基本语法 `subprocess.run(args, *, stdin=None, input=None, stdout=None, stderr=None, shell=False, timeout=None, check=False, encoding=None, errors=None)` 其中： - `args`: 要执行的命令及其参数，通常是一个列表形式。 - `stdin`, `stdout`, `stderr`: 定义输入/输出流的行为。 - `shell`: 是否通过壳层解释器执行命令，默认为 False。 - `check`: 如果设置为 True，则当命令返回非零退出码时会抛出异常。 - `timeout`: 设置超时时间（秒），超过此时间未完成则终止操作。 - `text` (Python 3.7+): 控制是否以文本模式读取数据。 - `capture_output`: 自动捕获标准输出和错误输出。 #### 示例代码 以下是一些常见的用法： ```python import subprocess # 执行简单的命令并获取输出 result = subprocess.run(['echo', 'Hello World'], capture_output=True, text=True) print("Command Output:", result.stdout) # 处理可能发生的错误 try: result = subprocess.run( ['false'], # 这是一个总是失败的命令 check=True, capture_output=True, text=True ) except subprocess.CalledProcessError as e: print(f"An error occurred: {e.stderr}") # 使用 shell=True 来支持更复杂的 Shell 功能 output = subprocess.run('dir C:\\', shell=True, capture_output=True, text=True, encoding='utf-8') print(output.stdout) # 结合 timeout 参数防止长时间挂起 try: output = subprocess.run(['sleep', '5'], timeout=3, capture_output=True, text=True) except subprocess.TimeoutExpired: print("The command timed out.") ``` #### 返回值解析 `subprocess.run()` 的返回值是一个 `CompletedProcess` 对象，包含了以下几个属性： - `returncode`: 子进程的退出状态码，成功通常是 0。 - `args`: 提供给函数的实际参数。 - `stdout`: 标准输出的内容（如果被捕捉的话）[^4]。 - `stderr`: 错误输出的内容（如果被捕捉的话）[^2]。 例如，在下面的例子中展示了如何访问这些字段： ```python completed_process = subprocess.run( ["