python的subprocess.popen的简单用法 Python中subp

前言

subprocess.run()是 Python 3 中用于执行体系命令的一个重要函数。它提供了一个简洁、强大且直观的方式来运行外部程序或体系命令，特别适用于那些需要和体系交互或者需要调用外部可执行程序的场景。在这篇文章中，我们将详细讨论怎样使用subprocess.run()函数，特别是check=True的用法，以及怎样处理其情形和结局。

1.subprocess.run()概述

subprocess.run()是subprocess模块的一部分，它是替代旧版模块（如os.system()）的更强大且安全的技巧。其主要目的是允许我们在 Python 中执行外部命令，并捕获输出、错误信息以及返回情形。

基本的语法如下：

import subprocessresult = subprocess.run(command, check=True, …)

在这个语法中，command一个字符串或列表，用于表示要执行的体系命令。check=True表示如果命令执行失败（即返回非零退出码），函数将抛出一个subprocess.CalledProcessError异常。

2.subprocess.run()参数详解

command：一个列表或字符串，表示要执行的命令。使用列表形式更安全，由于它可以避免 shell 注入风险。例如[&039;ls&039;, &039;-l&039;]而不是&039;ls -l&039;。
check：布尔值，默认是False。如果设为True，命令返回非零退出情形码时会引发CalledProcessError异常。这个参数非常有用，尤其是在处理必须执行成功的命令时，可以避免继续执行错误逻辑。
stdout：定义怎样处理命令的标准输出，例如设置为subprocess.PIPE可以捕获输出。
stderr：类似于stdout，用于处理标准错误输出。
text：如果设为True，会将输出解码为字符串，否则返回字节类型。
capture_output：如果设为True，则同时捕获标准输出和标准错误。

3. 一个基本例子

来看一个简单的例子：

import subprocesstry: result = subprocess.run([‘ls’, ‘-l’], check=True, text=True, capture_output=True) print(“标准输出:”, result.stdout)except subprocess.CalledProcessError as e: print(“命令执行失败，错误码:”, e.returncode) print(“错误输出:”, e.stderr)

在这个例子中：

我们使用[&039;ls&039;, &039;-l&039;]作为要执行的命令。
check=True表示如果命令返回非零的情形码，程序会抛出异常。
text=True会将输出解码为字符串，方便打印和处理。
capture_output=True会捕获命令的输出和错误。

4. 处理命令的执行情形

当我们使用subprocess.run()执行命令时，可以通过下面内容几种方式来处理命令的情形和结局：

捕获返回码：
- subprocess.CompletedProcess对象的returncode属性存储了命令执行后的返回码。如果返回码为0，则表示执行成功；否则表示失败。
result = subprocess.run([‘ls’, ‘-l’], text=True, capture_output=True)if result.returncode == 0: print(“命令执行成功”)else: print(“命令执行失败，返回码:”, result.returncode)
使用check=True处理异常：
- 当check=True时，非零的返回码会引发subprocess.CalledProcessError异常，这样我们就可以用try...except块来处理错误情况。
try: subprocess.run([‘false’], check=True)except subprocess.CalledProcessError as e: print(f”命令执行失败，错误码: e.returncode}”)
这个例子中，false一个始终返回非零情形码的命令，因此会触发异常处理块。
捕获输出：
- 如果希望查看命令的标准输出或标准错误，可以使用capture_output=True或直接设置stdout和stderr参数。
result = subprocess.run([‘echo’, ‘Hello, World!’], text=True, capture_output=True)print(“标准输出:”, result.stdout)
在这里，result.stdout会包含命令的输出内容"Hello, World!n"。
处理标准错误输出：
- 类似于标准输出，标准错误输出可以使用result.stderr捕获。例如：
try: result = subprocess.run([‘ls’, ‘/nonexistent’], check=True, text=True, capture_output=True)except subprocess.CalledProcessError as e: print(“错误输出:”, e.stderr)
在这种情况下，如果/nonexistent目录不存在，错误信息会被捕获并打印出来。

5.subprocess.CompletedProcess对象

subprocess.run()返回一个subprocess.CompletedProcess对象，它包含了多个属性：

args：执行的命令。
returncode：命令执行的返回码，0 表示成功，非零表示失败。
stdout：标准输出的内容（如果设置了capture_output=True或stdout=subprocess.PIPE）。
stderr：标准错误输出的内容（如果设置了capture_output=True或stderr=subprocess.PIPE）。

一个例子来展示这些属性：

result = subprocess.run([‘echo’, ‘Python subprocess module!’], text=True, capture_output=True)print(“命令:”, result.args)print(“返回码:”, result.returncode)print(“标准输出:”, result.stdout)

在这个例子中，result对象包含了所有与命令执行相关的信息，这使得它非常灵活，适用于处理各种执行情况。

6. 重点拎出来说

subprocess.run()是 Python 中一个非常有用的工具，用于与体系命令交互。通过设置不同的参数，我们可以轻松控制命令的执行、捕获其输出、检查其情形以及处理可能的错误。在使用check=True时，函数会自动处理失败情况，通过抛出异常的方式提醒开发者注意到命令的失败，这在编写更稳健的脚本时尤其有用。

使用subprocess.run()的一些最佳操作包括：

优先使用列表而不是字符串作为命令，以避免潜在的 shell 注入风险。
结合check=True使用异常处理，这样可以更好地处理命令执行失败的情况。
捕获输出并处理，确保命令的输出被正确记录或用于后续逻辑。

通过这些技巧，我们可以充分利用subprocess.run()的功能，编写高效且安全的 Python 脚本。

到此这篇关于Python中subprocess.run()执行命令、检查情形与结局处理的文章就介绍到这了,更多相关Python subprocess.run()详解内容请搜索风君子博客以前的文章或继续浏览下面的相关文章希望大家以后多多支持风君子博客！

无论兄弟们可能感兴趣的文章:

Python中os.system()、subprocess.run()、call()、check_output()的使用案例
python?subprocess.run()、subprocess.Popen()、subprocess.check_output()
python?subprocess.run中的具体使用

巴马商祺