应使用 subprocess.run() 替代 os.system() 和 os.popen(),传入参数列表而非拼接字符串,禁用 shell=True,显式控制 env 和 cwd,并警惕 SUID 二进制与环境变量劫持风险。

subprocess.run() 是最安全的起点
Python 3.5+ 推荐直接用 subprocess.run(),它默认不启用 shell,避免命令注入风险,也更易捕获输出和错误。别一上来就用 os.system() 或带 shell=True 的 subprocess.Popen()。
- 想执行命令并等它结束?用
subprocess.run() - 需要实时读取输出流(比如进度条)?才考虑
subprocess.Popen()配合.stdout.readline() - 传参时永远用列表形式:
['ls', '-l', '/tmp'],不要拼接字符串 - 如果非得走 shell(比如用管道
|、通配符*),必须显式写shell=True,且只对可信输入这么做
捕获输出时要注意 encoding 和异常
默认情况下 subprocess.run() 返回的是字节串(bytes),直接打印可能报 UnicodeDecodeError;同时,命令失败不会抛异常——除非你加 check=True。
- 加
text=True让 stdout/stderr 自动解码为str(推荐) - 加
encoding='utf-8'显式指定编码(尤其在 Windows 或非 UTF 环境下) - 加
check=True让非零退出码立刻抛subprocess.CalledProcessError - 错误信息在异常对象的
.stderr属性里,不是print(e)就能看见的
result = subprocess.run(['git', 'status'],
capture_output=True, text=True, check=False)
if result.returncode != 0:
print("Git error:", result.stderr)
传参含空格或特殊字符时别用 shell=True
很多人遇到路径含空格就加 shell=True,结果引入注入漏洞。其实 subprocess 本身完全支持带空格的路径——只要参数拆成列表元素即可。
当现有的脚本或服务需要将作用域化的仓库工作委托给 Claude Code 并以编程方式消费结构化响应时,请使用 Claude Agent SDK for Python。
- ✅ 正确:
['/path/with space/mytool', '--input', 'file name.txt'] - ❌ 危险:
subprocess.run(f'/path/with space/mytool --input "file name.txt"', shell=True) -
shell=True下,user_input直接拼进字符串会导致命令被篡改,比如user_input = 'a.txt; rm -rf /' - Windows 上路径分隔符用
/或os.path.join()都行,subprocess能正确处理
Popen 实时读取 stdout 容易卡死
用 subprocess.Popen() 做流式处理时,常见问题是子进程 stdout 缓冲导致阻塞,或者没关流引发死锁。
立即学习“Python免费学习笔记(深入)”;
- 加
bufsize=1和universal_newlines=True(或text=True)启用行缓冲 - 别同时用
stdout=subprocess.PIPE和stderr=subprocess.STDOUT再调.communicate()——这会等全部结束,失去“实时”意义 - 真正实时读:用
for line in iter(p.stdout.readline, ''):循环,但要确保子进程输出换行 - 记得调
p.stdout.close()和p.wait(),否则可能残留僵尸进程
复杂交互(如需要输入再读输出)建议用 pexpect 或 ptyprocess,原生 subprocess 不适合模拟终端会话。

















