subprocess 外部命令
run / 返回值 / stdout / 参数列表 / 超时 / 安全
一、本章介绍
subprocess 让你从 Python 里启动外部程序(比如调用系统命令、另一个脚本)。最常用的是 subprocess.run,它返回 CompletedProcess 对象,含 returncode、stdout、stderr。
这一章用「调用 Python 自己」做演示(跨平台安全),覆盖捕获输出、检查返回码、超时、参数列表传递,以及为什么不要用 shell=True 拼接字符串。
本章要点
- subprocess.run 基本用法
- capture_output 捕获 stdout/stderr
- returncode 判断成功失败
- text=True 得到字符串
- timeout 超时控制
- 参数用列表而非拼接字符串
二、先看 demo
下面这个例子把本章涉及的用法尽量全面地串了一遍,代码带逐行注释,可以直接复制到本地 .py 文件运行。
先看一个完整例子
介绍 · 逐行注释import subprocess, sys
py = sys.executable # 当前 Python 解释器路径,跨平台安全
# 1) 基本运行:打印 hello
r = subprocess.run([py, "-c", "print('hello')"], capture_output=True, text=True)
print("输出", repr(r.stdout.strip()))
print("返回码", r.returncode)
# 2) 计算并捕获 stdout
r = subprocess.run([py, "-c", "print(6*7)"], capture_output=True, text=True)
print("捕获结果", r.stdout.strip())
# 3) 通过参数列表传值(不用拼字符串)
r = subprocess.run([py, "-c", "import sys;print(sys.argv[1])", "小明"],
capture_output=True, text=True)
print("参数传入", r.stdout.strip())
# 4) 非零返回码表示失败
r = subprocess.run([py, "-c", "import sys;sys.exit(3)"], capture_output=True, text=True)
print("失败码", r.returncode)
# 5) check=True 失败时抛异常
try:
subprocess.run([py, "-c", "import sys;sys.exit(1)"], check=True,
capture_output=True, text=True)
except subprocess.CalledProcessError as e:
print("捕获异常", e.returncode)
# 6) timeout 超时
try:
subprocess.run([py, "-c", "import time;time.sleep(5)"], timeout=1,
capture_output=True, text=True)
except subprocess.TimeoutExpired:
print("超时已处理")
# 7) 安全写法:参数用列表,不用 shell=True 拼接
cmd = [py, "-c", "print('safe')"]
r = subprocess.run(cmd, capture_output=True, text=True)
print("安全写法", r.stdout.strip())输出 'hello'
返回码 0
捕获结果 42
参数传入 灏忔槑
失败码 3
捕获异常 1
超时已处理
安全写法 safe要点:subprocess.run([程序, 参数1, 参数2]) 用列表传参数,不要用字符串拼接,更不要轻易用 shell=True(有命令注入风险)。capture_output=True 捕获输出,text=True 让 stdout 是字符串而不是字节。returncode 为 0 表示成功;check=True 会在失败时抛 CalledProcessError;timeout 防卡死。
三、6 个任务(自己先写,再看答案)
难度从入门到挑战逐步增加。每个任务的答案默认折叠,点开可看参考代码、运行结果;有第二种解法的也一并给出。代码都可以直接运行。
run 基本用法
自己写 · 附答案入门 ★☆☆用 sys.executable 运行 print('hi') 并打印 stdout 去掉换行
参考答案(先自己写,再看)
import subprocess,sys
r=subprocess.run([sys.executable,"-c","print('hi')"],capture_output=True,text=True)
print(r.stdout.strip())hi查看返回码
自己写 · 附答案入门 ★☆☆运行 print(1) 打印 returncode
参考答案(先自己写,再看)
import subprocess,sys
r=subprocess.run([sys.executable,"-c","print(1)"],capture_output=True,text=True)
print(r.returncode)0传参数
自己写 · 附答案进阶 ★★☆用 -c 读 sys.argv[1] 传入 'AB' 并打印结果
参考答案(先自己写,再看)
import subprocess,sys
r=subprocess.run([sys.executable,"-c","import sys;print(sys.argv[1])","AB"],capture_output=True,text=True)
print(r.stdout.strip())AB非零返回码
自己写 · 附答案进阶 ★★☆运行 sys.exit(2) 打印 returncode
参考答案(先自己写,再看)
import subprocess,sys
r=subprocess.run([sys.executable,"-c","import sys;sys.exit(2)"],capture_output=True,text=True)
print(r.returncode)2check 抛异常
自己写 · 附答案挑战 ★★★用 check=True 运行 sys.exit(1),捕获 CalledProcessError 打印返回码
参考答案(先自己写,再看)
import subprocess,sys
try:
subprocess.run([sys.executable,"-c","import sys;sys.exit(1)"],check=True,capture_output=True)
except subprocess.CalledProcessError as e:
print(e.returncode)1超时处理
自己写 · 附答案挑战 ★★★用 timeout=1 运行 sleep(3),捕获 TimeoutExpired 打印 ok
参考答案(先自己写,再看)
import subprocess,sys
try:
subprocess.run([sys.executable,"-c","import time;time.sleep(3)"],timeout=1,capture_output=True)
except subprocess.TimeoutExpired:
print("ok")ok