使用Python为路径字符串空格前添加单个转义符供subprocess调用的方法咨询

分为两种场景处理，优先推荐第一种方案，不需要手动处理任何路径转义：

1. subprocess使用列表传参（最优方案） #

subprocess官方推荐将命令拆分为列表形式传参，每个参数作为列表的单独元素，路径中的空格、特殊字符会自动被处理，不需要额外转义：

import subprocess
path = "foo/foo bar/bar"
# 示例：执行ls命令查看对应路径
result = subprocess.run(["ls", path], capture_output=True, text=True)
print(result.stdout)

该方式同时可以避免shell注入风险，是所有场景下的首选。

2. 必须使用shell=True或os.system的场景 #

如果需要用到shell的管道、通配符等特性不得不开启shell=True，或者使用os.system调用命令，可以使用Python标准库的shlex.quote()自动完成路径的shell转义，不需要手动替换字符：

import subprocess
import shlex
import os

path = "foo/foo bar/bar"
# 自动完成shell兼容的转义处理
quoted_path = shlex.quote(path)

# subprocess + shell=True 示例
subprocess.run(f"ls -l {quoted_path}", shell=True)

# os.system 示例
os.system(f"ls -l {quoted_path}")

shlex.quote会自动处理空格、引号、$等所有shell特殊字符，比手动替换的兼容性更强。

常见错误原因说明 #

• 手动替换空格后得到的foo/foo\\ bar/bar是Python打印字符串repr形式的结果，实际字符串中仅存储一个反斜杠，但是手动替换无法兼容其他特殊字符的转义需求。
• os.path.normpath仅用于处理路径的层级符号（如/、..、.），不负责shell转义，因此调用后无变化是正常表现。
• 调用repr()会额外对反斜杠做二次转义，因此会出现四个反斜杠的错误结果，该方法不适用于当前场景。

内容的提问来源于stack exchange，提问作者Yes