目录/第 60 章 · subprocess 外部命令
第 60 章 / 70 · 高级 · 标准库深入

subprocess 外部命令

run / 返回值 / stdout / 参数列表 / 超时 / 安全

先介绍1 个 demo6 个任务答案可展开

一、本章介绍

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 个任务(自己先写,再看答案)

难度从入门到挑战逐步增加。每个任务的答案默认折叠,点开可看参考代码、运行结果;有第二种解法的也一并给出。代码都可以直接运行。

任务 1

run 基本用法

自己写 · 附答案入门 ★☆☆
解题提示:本题主要用到 subprocess.run 基本用法、capture_output 捕获 stdout/stderr、returncode 判断成功失败。先对照要求自己写一遍,卡住了再展开答案。

用 sys.executable 运行 print('hi') 并打印 stdout 去掉换行

我的代码草稿(可复制到本地 .py 文件运行)
参考答案(先自己写,再看)
参考答案一
import subprocess,sys
r=subprocess.run([sys.executable,"-c","print('hi')"],capture_output=True,text=True)
print(r.stdout.strip())
运行结果
hi
任务 2

查看返回码

自己写 · 附答案入门 ★☆☆
解题提示:本题主要用到 subprocess.run 基本用法、capture_output 捕获 stdout/stderr、returncode 判断成功失败。先对照要求自己写一遍,卡住了再展开答案。

运行 print(1) 打印 returncode

我的代码草稿(可复制到本地 .py 文件运行)
参考答案(先自己写,再看)
参考答案一
import subprocess,sys
r=subprocess.run([sys.executable,"-c","print(1)"],capture_output=True,text=True)
print(r.returncode)
运行结果
0
任务 3

传参数

自己写 · 附答案进阶 ★★☆
解题提示:本题主要用到 subprocess.run 基本用法、capture_output 捕获 stdout/stderr、returncode 判断成功失败。先对照要求自己写一遍,卡住了再展开答案。

用 -c 读 sys.argv[1] 传入 'AB' 并打印结果

我的代码草稿(可复制到本地 .py 文件运行)
参考答案(先自己写,再看)
参考答案一
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
任务 4

非零返回码

自己写 · 附答案进阶 ★★☆
解题提示:本题主要用到 subprocess.run 基本用法、capture_output 捕获 stdout/stderr、returncode 判断成功失败。先对照要求自己写一遍,卡住了再展开答案。

运行 sys.exit(2) 打印 returncode

我的代码草稿(可复制到本地 .py 文件运行)
参考答案(先自己写,再看)
参考答案一
import subprocess,sys
r=subprocess.run([sys.executable,"-c","import sys;sys.exit(2)"],capture_output=True,text=True)
print(r.returncode)
运行结果
2
任务 5

check 抛异常

自己写 · 附答案挑战 ★★★
解题提示:本题主要用到 subprocess.run 基本用法、capture_output 捕获 stdout/stderr、returncode 判断成功失败。先对照要求自己写一遍,卡住了再展开答案。

用 check=True 运行 sys.exit(1),捕获 CalledProcessError 打印返回码

我的代码草稿(可复制到本地 .py 文件运行)
参考答案(先自己写,再看)
参考答案一
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
任务 6

超时处理

自己写 · 附答案挑战 ★★★
解题提示:本题主要用到 subprocess.run 基本用法、capture_output 捕获 stdout/stderr、returncode 判断成功失败。先对照要求自己写一遍,卡住了再展开答案。

用 timeout=1 运行 sleep(3),捕获 TimeoutExpired 打印 ok

我的代码草稿(可复制到本地 .py 文件运行)
参考答案(先自己写,再看)
参考答案一
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