Python使用subprocess模块轻松调用外部程序与命令

 更新时间:2026年04月24日 08:32:20   作者:科雷learning  
subprocess是Python的标准库,它的设计目标是替代旧有的os.system、os.popen等模块,提供更统一、更强大的子进程管理功能,所以本文给大家介绍了Python如何使用subprocess模块轻松调用外部程序与命令,需要的朋友可以参考下

01 subprocess模块简介

subprocess是Python的标准库,它的设计目标是替代旧有的os.system、os.popen等模块,提供更统一、更强大的子进程管理功能。使用subprocess可以启动外部程序、获取程序执行结果、管理进程的输入输出和错误信息,在自动化脚本、系统管理、程序集成等场景中发挥重要作用。

02 核心函数介绍与案例

1. subprocess.run():执行命令并等待完成

subprocess.run()是subprocess模块中最常用的函数,用于执行指定的命令,并等待命令执行完毕。它接受args参数(命令及其参数),以及input等可选参数,返回一个CompletedProcess对,包含命令执行结果信息。

参数介绍:

1)popenargs:指定要执行的命令及参数

popenargs是subprocess.run()中最核心的参数,必须传入,它用于指定要执行的外部命令及其参数。args通常以列表形式传递,列表的第一个元素是命令本身,后续元素为命令的参数。

案例:执行简单命令

import subprocess
# 执行ls命令,获取当前目录下的文件列表
result = subprocess.run(['ls', '-l'], capture_output=True, text=True)
if result.returncode == 0:
    print("命令执行成功,输出如下:")
    print(result.stdout)
else:
    print(f"命令执行失败,错误信息:{result.stderr}")

说明:代码中使用subprocess.run()执行ls -l命令,capture_output=True表示捕获命令的标准输出和标准错误输出,text=True则以文本形式返回输出结果。通过检查returncode判断命令是否执行成功。

2)stdin、stdout、stderr:控制输入输出和错误流

  • stdin:指定子进程的标准输入,可以是文件对象、字节串或字符串(当text=True时)。如果不指定,子进程的标准输入将继承父进程的标准输入。
  • stdout:指定子进程的标准输出,常见取值为subprocess.PIPE(用于捕获输出)、文件对象或None(默认继承父进程的标准输出)。
  • stderr:指定子进程的标准错误输出,取值和用法与stdout类似。

案例:捕获命令的输出和错误信息

import subprocess
# 执行一个错误的命令,捕获输出和错误
result = subprocess.run(['ls', 'nonexistent_file'], stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
print("标准输出:", result.stdout)
print("标准错误:", result.stderr)
#输出为:
标准输出: 
标准错误: ls: nonexistent_file: No such file or directory

3)capture_output:快速捕获输出和错误

capture_output是一个布尔值参数,当设置为True时,相当于同时将stdout和stderr设置为subprocess.PIPE,并自动捕获子进程的标准输出和标准错误。

案例:使用capture_output简化代码

import subprocess
# 执行一个错误的命令,捕获输出和错误
result = subprocess.run(['ls', 'nonexistent_file'],capture_output=True, text=True)
print("标准输出:", result.stdout)
print("标准错误:", result.stderr)

4)shell:使用系统shell执行命令

shell是一个布尔值参数,默认为False。当shell=True时,命令会通过系统的shell(如bash)执行,此时执行命令可以是字符串形式,如下“ls nonexistent_file”。

import subprocess
# 执行一个错误的命令,捕获输出和错误
result = subprocess.run('ls nonexistent_file',shell=True,capture_output=True, text=True)
print("标准输出:", result.stdout)
print("标准错误:", result.stderr)

但这种方式可能会引入安全问题,例如:

import subprocess
user_input = "; rm -rf /"# 恶意输入示例
# 危险操作!可能会删除系统根目录
subprocess.run(f'echo {user_input}', shell=True)

因此,除非必要,否则不建议使用shell=True,若确实需要,可以考虑使用shlex.quote对输入进行转义。

5)cwd:指定子进程的工作目录

cwd参数用于指定子进程执行时的工作目录。如果不指定,子进程将在父进程的当前工作目录下执行。

案例:在指定目录下执行命令

import subprocess
# 在/tmp目录下执行ls命令
result = subprocess.run(['ls'], cwd='/tmp', capture_output=True, text=True)
print(result.stdout)

6)timeout:设置命令执行的超时时间

timeout参数用于设置子进程执行的最长时间(单位为秒)。如果子进程在指定时间内未执行完毕,将引发subprocess.TimeoutExpired异常。

案例:设置命令执行超时

import subprocess
try:
# 执行ping命令,设置超时时间为5秒
    result = subprocess.run(['ping', 'www.baidu.com'], timeout=5, capture_output=True, text=True)
    print(result.stdout)
except subprocess.TimeoutExpired:
    print("命令执行超时!")

7)check:检查命令执行状态

check是一个布尔值参数,默认为False。当check=True时,如果子进程的返回码不为0,将引发
subprocess.CalledProcessError异常。

案例:检查命令是否执行成功

import subprocess
try:
# 执行一个可能失败的命令,开启check检查
 result = subprocess.run(['ls','nonexistent_file'], check=True, capture_output=True, text=True)
except subprocess.CalledProcessError:
 print("命令执行失败!")

2. subprocess.Popen():创建并管理子进程

subprocess.Popen()函数用于创建一个新的子进程,并返回一个Popen对象,通过该对象可以控制子进程的执行、获取输出、与子进程进行交互

subprocess.Popen()是subprocess模块的底层接口,与run()的主要区别在于:

  • 阻塞 vs 非阻塞:run()是阻塞式的(等待命令执行完毕),而Popen()是非阻塞式的(立即返回进程对象)。
  • 灵活性:Popen()提供更底层的控制,适合需要实时交互或复杂进程管理的场景。

参数介绍:

1)args:命令及参数

与run()相同,指定要执行的命令。推荐使用列表形式,避免安全风险。

import subprocess
# 正确写法:列表形式
p = subprocess.Popen(['ls', '-l'], stdout=subprocess.PIPE)
# 危险写法(shell=True):
# p = subprocess.Popen('ls -l', shell=True)

2)stdin/stdout/stderr:控制输入输出

与run()类似,但更灵活,支持实时处理流数据。

常见取值

  • subprocess.PIPE:创建管道,用于捕获输出或提供输入。
  • 文件对象:将输出 / 输入重定向到文件。
  • None(默认):继承父进程。

案例:实时获取命令输出

import subprocess
# 执行命令并实时获取输出
p = subprocess.Popen(['ping', 'www.baidu.com'], stdout=subprocess.PIPE, text=True)
# 逐行读取输出
for line in iter(p.stdout.readline, ''):
    print(line.strip())
p.wait()  # 等待进程结束

3)shell:通过shell执行命令(慎用)

与run()的shell参数功能相同,但风险更高。仅在必要时使用,并确保输入经过严格过滤。

# 安全风险示例(切勿在生产环境使用)
user_input = "example.txt; rm -rf /"
subprocess.Popen(f'cat {user_input}', shell=True)

4)cwd:指定工作目录

与run()的cwd参数功能相同。

import subprocess
# 在/tmp目录下执行命令
p = subprocess.Popen(['ls'], cwd='/tmp', stdout=subprocess.PIPE)
print(p.stdout.read().decode())

5)env:自定义环境变量

覆盖或添加子进程的环境变量。(有些命令执行时需要获取环境变量信息,否则执行shell命令可能会报错)

import subprocess
import os
# 自定义环境变量
my_env = {**os.environ, 'MY_VAR': 'custom_value'}
p = subprocess.Popen(['printenv', 'MY_VAR'], env=my_env, stdout=subprocess.PIPE)
print(p.stdout.read().decode())  # 输出: custom_value

6)bufsize:控制缓冲区大小

  • -1(默认):使用系统默认缓冲区大小。
  • 0:无缓冲(仅适用于stdin、stdout、stderr为管道时)。
  • 1:行缓冲(仅在text=True时有效)。
  • >1:指定缓冲区大小(字节)。
# 无缓冲模式,实时获取输出
p = subprocess.Popen(['ls'], stdout=subprocess.PIPE, bufsize=0)

7)start_new_session(Windows/Linux)

在新会话中启动进程。

# 在Windows或Linux上创建新会话
p = subprocess.Popen(['python', 'script.py'], start_new_session=True)

一些应用场景

1). 实时监控命令输出

import subprocess
# 实时监控日志文件
p = subprocess.Popen(['tail', '-f', '/var/log/syslog'], stdout=subprocess.PIPE, text=True)
try:
    for line in iter(p.stdout.readline, ''):
        print(f"日志: {line.strip()}")
except KeyboardInterrupt:
    p.terminate()  # 按Ctrl+C终止监控

2). 并行执行多个命令

import subprocess
import time
# 并行执行多个命令
commands = [
    ['sleep', '2'],
    ['ls', '-l'],
    ['echo', 'Hello']
]
processes = [subprocess.Popen(cmd) for cmd in commands]
# 等待所有进程结束
for p in processes:
    p.wait()
print("所有命令执行完毕")

3). 复杂交互场景(如FTP客户端)

import subprocess
# 启动交互式FTP客户端
p = subprocess.Popen(['ftp', 'ftp.example.com'], 
stdin=subprocess.PIPE, 
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,text=True)
# 发送登录命令
p.stdin.write('user\n')
p.stdin.write('password\n')
p.stdin.flush()
# 读取响应
output = p.stdout.read(1024)

Popen对象的其他方法

方法

描述

p.wait(timeout)

等待进程结束并返回返回码,可设置超时(超时抛出TimeoutExpired)。

p.communicate(input=None, timeout=None)

与进程交互(发送输入、获取输出),等待进程结束。

p.send_signal(signal)

向进程发送信号(如signal.SIGTERM)。

p.terminate()

终止进程(发送 SIGTERM 信号)。

p.kill()

强制杀死进程(发送 SIGKILL 信号)。

p.poll()

检查进程是否结束,返回返回码(未结束返回None)。

3. subprocess.check_output():执行命令并返回输出

subprocess.check_output()函数执行指定命令,若命令执行成功,返回命令的标准输出;若执行失败(返回码非 0),则抛出CalledProcessError异常。

案例:获取系统磁盘空间信息

import subprocess
try:
    result = subprocess.check_output(['df', '-h'], text=True)
    print("磁盘空间信息:")
    print(result)
except subprocess.CalledProcessError as e:
    print(f"命令执行失败,错误码:{e.returncode},错误信息:{e.output}")

说明:代码执行df -h命令获取磁盘空间信息,若命令执行失败,捕获异常并输出错误信息。

subprocess模块赋予了Python与外部世界交互的强大能力,通过掌握这些核心函数,我们可以在 Python开发中实现更丰富的功能,无论是自动化运维、数据采集,还是程序集成,subprocess都能成为你的得力助手。

以上就是Python使用subprocess模块轻松调用外部程序与命令的详细内容,更多关于Python subprocess调用外部程序与命令的资料请关注脚本之家其它相关文章!

相关文章

  • pytorch-gpu安装的经验与教训

    pytorch-gpu安装的经验与教训

    本文主要介绍了pytorch-gpu安装的经验与教训,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2023-01-01
  • Python 正则表达式(转义问题)

    Python 正则表达式(转义问题)

    这篇文章主要介绍了Python 正则表达式(转义问题),需要的朋友可以参考下
    2014-12-12
  • Python求均值,方差,标准差的实例

    Python求均值,方差,标准差的实例

    今天小编就为大家分享一篇Python求均值,方差,标准差的实例,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2019-06-06
  • Python利用wxPython制作一个有趣的验证码生成器

    Python利用wxPython制作一个有趣的验证码生成器

    这篇文章主要为大家详细介绍了Python如何利用wxPython制作一个简单有趣的验证码生成器,文中的示例代码讲解详细,需要的小伙伴可以了解一下
    2023-04-04
  • Python面向对象进阶学习

    Python面向对象进阶学习

    在本文里我们整理了关于Python面向对象的进阶学习知识点以及学习路线等内容,有兴趣的朋友们学习下。
    2019-05-05
  • python音频处理用到的操作的示例代码

    python音频处理用到的操作的示例代码

    本篇文章主要介绍了python音频处理用到的操作的示例代码,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-10-10
  • Python mlxtend库数据科学和机器学习补充工具功能探索

    Python mlxtend库数据科学和机器学习补充工具功能探索

    这篇文章主要介绍了Python mlxtend库数据科学和机器学习补充工具功能探索,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2024-01-01
  • python读写csv文件并增加行列的实例代码

    python读写csv文件并增加行列的实例代码

    这篇文章主要介绍了python读写csv文件并增加行列的实现方法,文中给大家介绍了python写入csv文件的几种方法总结,给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2019-08-08
  • 一文分享Python中五大高频使用的基础操作

    一文分享Python中五大高频使用的基础操作

    作为一个常年和 Python 打交道的 搬砖人,我发现很多新手甚至老手,都会忽略一些基础但超实用的小技巧,今天就来分享几个日常高频使用的 Python 基础操作吧
    2026-01-01
  • python中关于CIFAR10数据集的使用

    python中关于CIFAR10数据集的使用

    这篇文章主要介绍了python中关于CIFAR10数据集的使用方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-02-02

最新评论