Python如何调用系统命令？subprocess模块解析-Python教程-PHP中文网

Python如何调用系统命令？subprocess模块解析

絕刀狂花

发布： 2025-07-12 14:44:01

原创

917人浏览过

推荐使用subprocess模块执行系统命令。在python中，执行系统命令最推荐的方式是使用标准库中的subprocess模块，其功能强大且灵活，能替代旧方法如os.system()。1. subprocess.run()是从python 3.5开始的首选方式，适合基础场景，例如运行命令并捕获输出需用列表传参、capture_output=true和text=true。2. 命令执行成功与否可通过returncode属性判断，0表示成功，非零为错误码；check=true可在失败时抛出异常。3. 需要精细控制输入输出流或交互时应使用popen类，支持双向通信及持续交互，并可配置stdin、stdout、cwd等选项。4. 使用shell=true时需注意安全问题，尤其处理用户输入时防范命令注入风险。5. 跨平台兼容性方面，subprocess本身跨平台但命令可能不兼容，建议避免硬编码平台相关命令，优先使用python内置模块实现文件操作等功能。掌握subprocess.run()能满足大部分需求，复杂场景再使用popen深入处理。

Python如何调用系统命令？subprocess模块解析

在Python中执行系统命令，最推荐的方式是使用标准库中的subprocess模块。它功能强大、灵活，并且能很好地替代旧的如os.system()或os.spawn*等方法。如果你需要在Python脚本中运行外部命令并获取结果，那subprocess就是你要找的工具。

一、subprocess.run：最常用的基础方法

从Python 3.5开始，subprocess.run()成为调用系统命令的首选方式。它的接口清晰，适合大多数基础场景。

例如，想运行一个简单的命令，比如查看当前目录下的文件：

立即学习“Python免费学习笔记（深入）”；

import subprocess

result = subprocess.run(['ls', '-l'], capture_output=True, text=True)
print(result.stdout)

登录后复制

这里有几个关键点：

命令参数要以列表形式传入，每个参数单独作为一个元素。
capture_output=True表示捕获标准输出和标准错误。
text=True会将输出转为字符串而不是字节流（Python 3.7+）。
result.stdout是你想要的标准输出内容。

如果只是运行命令而不需要处理输出，可以不加capture_output。

二、获取命令返回值和状态码

很多时候你不仅想知道命令输出了什么，还想了解它是否成功执行。这时就要看returncode属性。

比如运行一个不存在的命令：

res = subprocess.run(['not_a_real_cmd'], capture_output=True, text=True)
print(res.returncode)  # 返回非0表示出错
print(res.stderr)      # 通常会有错误信息

登录后复制

常见情况：

returncode 为 0 表示成功
非零值通常是错误码，不同命令含义不同

如果你想在命令失败时直接抛出异常，可以加上参数check=True，这样一旦命令执行失败就会触发CalledProcessError异常。

三、更复杂的交互：Popen类

当你需要更精细地控制子进程输入输出流，或者需要与进程进行持续交互时，应该使用subprocess.Popen类。

比如，你可以一边写入输入流，一边读取输出流：

proc = subprocess.Popen(['grep', 'hello'], stdin=subprocess.PIPE, stdout=subprocess.PIPE, text=True)
stdout, stderr = proc.communicate('hello world\nhi there\nhello again')
print(stdout)

登录后复制

这个例子中我们手动向grep命令传入了一些文本，并得到了匹配的结果。这种方式非常适合自动化测试、长时间运行的子进程或需要双向通信的场景。

一些常见配置选项：