在Python 3.12中如何利用Subprocess模块执行Shell批处理命令？-Python教程-PHP中文网

subprocess.run()是Python 3.5起推荐的执行外部命令首选方式，安全、可控、功能完备，取代os.system()等旧方法。

在python 3.12中如何利用subprocess模块执行shell批处理命令？

subprocess.run() 是执行 Shell 命令的首选方式

Python 3.12 中 subprocess.run() 已完全成熟，推荐替代已弃用的 os.system() 或不安全的 shell=True + 字符串拼接。它默认不启用 shell 解析，更安全、可控性更强。

常见错误是直接传入字符串命令（如 "ls -l | grep py"）并设 shell=True，这会引入注入风险，且在 Windows 上行为不一致。

简单命令用列表形式：例如 ["ls", "-l"]，无需 shell=True
需要管道或重定向时，避免拼接字符串；改用多个 subprocess.run() 链式调用 + stdout=subprocess.PIPE
若必须用 shell 功能（如通配符 *、&&），确保输入可信，并显式指定 shell=True 和 executable（Linux/macOS 用 /bin/sh，Windows 用 cmd.exe）

Windows 批处理（.bat）文件要显式调用 cmd.exe

直接传 ["script.bat"] 通常失败——Python 不会自动查找 .bat 关联程序。必须让 cmd.exe 解释执行。

正确做法是构造明确的 shell 调用：

subprocess.run(["cmd.exe", "/c", "script.bat"], check=True)

注意：/c 执行后退出，/k 会保持窗口打开（调试时有用）。不要省略 /c，否则 cmd.exe 可能挂起。

路径含空格？用完整路径并确保字符串本身不被 shell 二次解析（即不加 shell=True）
想捕获输出？加 capture_output=True, text=True
环境变量需继承？默认已继承，如需修改，传 env={**os.environ, "MY_VAR": "value"}

捕获输出与错误码必须显式处理

subprocess.run() 默认不抛异常，即使命令返回非零退出码。很多人误以为失败会报错，结果静默忽略错误。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

关键参数组合：

加 check=True：非零退出码触发 subprocess.CalledProcessError
加 capture_output=True：把 stdout 和 stderr 捕获到 result.stdout / result.stderr
加 text=True：返回字符串而非 bytes，避免手动解码

示例：

try:
    result = subprocess.run(
        ["python", "--version"],
        capture_output=True,
        text=True,
        check=True
    )
    print("Python 版本：", result.stdout.strip())
except subprocess.CalledProcessError as e:
    print("命令失败，退出码：", e.returncode)
    print("错误输出：", e.stderr)

timeout 和编码问题在 Python 3.12 中更严格

Python 3.12 对 timeout 的处理更精确，超时后子进程会被强制终止（SIGKILL），但其子进程可能残留。另外，默认编码不再宽松 fallback，遇到非法字节会直接报 UnicodeDecodeError。

应对方法：

始终设 timeout=30 类似值，防止挂起；超时后检查 result.stderr 是否为空，再决定是否重试
若目标命令输出不可控编码（如某些 Windows 工具输出 GBK），显式指定 encoding="gbk" 或 errors="replace"
避免依赖 sys.getdefaultencoding() —— 它和实际终端编码无关，应以 locale.getpreferredencoding() 或明确协议为准

跨平台脚本里，shell=True 的行为差异、编码隐式转换、子进程残留，这三个点最容易在上线后暴露。别依赖“本地跑通就行”。