Python subprocess库六个实例快速掌握

Owen
Owen
发布时间:2026-10-16| 4人浏览过
原创

本文通过6个Python subprocess库实例,详解subprocess.run()函数的核心用法。内容涵盖基础调用、返回值解析(args、returncode、stdout、stderr)、错误处理机制、标准输出捕获及与子进程通信(input参数)。适合希望掌握Python进程控制与脚本交互的开发者。

subprocess

官方中文文档

参考相关文档并结合实际开发经验,subprocess模块的主要作用是启动子进程来执行系统命令或脚本。这意味着我们可以在一个Python文件中调用并执行另一个Python脚本文件,实现进程间的交互与控制。

例1-快速使用subprocess

首先创建一个项目目录,并在该目录下准备两个Python文件。

|-demo |-main.py |-hello.py

在hello.py中

# hello.py
print('hello world!')

在main.py中

import subprocess
subprocess.run(['python', 'hello.py'])

执行main.py文件得到如下结果

hello world!

例2-subprocess.run()的返回值

修改代码如下:

# main.py
import subprocess
res = subprocess.run(['python', 'hello.py'])
print("args:", res.args)
print("returncode", res.returncode)

运行后

hello world! args: ['python', 'hello.py'] returncode: 0

returncode 表示你run的这个py文件过程是否正确,如果正确,返回0,否则返回1

例3-全面的返回值介绍

  • args:被用作启动进程的参数,可能是列表或字符串
  • returncode:子进程的退出状态码
  • stdout:从子进程捕获到的标准输出,但是没设置subprocess.run()中的stdout参数时,这一项是None。
  • stderr:捕获到的子进程标准错误,没设置subprocess.run()中的stderr参数时,这一项是None。
  • check_returncode():如果 returncode 非零, 抛出 CalledProcessError.

修改main.py

# main.py
import subprocess
res = subprocess.run(['python', 'hello.py'])
print("args:", res.args)
print("returncode", res.returncode)
print("stdout", res.stdout)
print("stderr", res.stderr)

结果:

hello world! args: ['python', 'hello.py'] returncode 0 stdout None stderr None

Process finished with exit code 0

可以看到,没有设置subprocess.run()中的参数stdout和stderr时,这两项都是None

例4-代码有bug的情况

新建fail.py,故意制造一个bug

# fail.py
a = 

修改main.py

# main.py
import subprocess
res = subprocess.run(['python', 'hello.py'])
res2 = subprocess.run(['python', 'fail.py'])

再运行main函数,得到返回

hello world! File "fail.py", line 2 a = ^ SyntaxError: invalid syntax

可以看到,先是正确打印了hello.py的内容,然后是fail.py的错误信息。

例5-捕获stdout和stderr

修改main.py

# main.py
import subprocess
res = subprocess.run(['python', 'hello.py'], stdout=subprocess.PIPE)
res2 = subprocess.run(['python', 'fail.py'], stderr=subprocess.PIPE)
print('hello.py stdout:', res.stdout)
print('fail.py stderr:', res2.stderr)

结果

hello.py stdout: b'hello world!\r\n' fail.py stderr: b' File "fail.py", line 2\r\n a =\r\n ^\r\nSyntaxError: invalid syntax\r\n'

可以通过res.stdout与res2.stderr分别拿到正确print的信息和错误信息。

同时可以发现,子进程print和报错内容就不会在父进程打印输出了。

注意这里的res.stdout是一串二进制字符串。如果设置encoding参数,拿到的就是字符串。

res = subprocess.run(['python', 'hello.py'], 
                     stdout=subprocess.PIPE,
                     encoding='utf8')

例6-与子进程进行通信

可以通过subprocess.run()的input参数给子进程发送消息。如果不设置encoding,就要传入二进制串,比如b'hello input'

# main.py
import subprocess
from subprocess import PIPE
res = subprocess.run(['python', 'hello.py'],
                     input='hello input',
                     encoding='utf8')

修改hello.py接收传进来的字符串。

# hello.py 
import sys
data = sys.stdin.read()
print(data)

结果

hello input

Process finished with exit code 0

到此这篇关于Python subprocess库六个实例快速掌握的文章就介绍到这了,更多相关Python subprocess库内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站!

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。