如何将-param:abc=def作为单个命令行参数传入subprocess？

问题根源 #

你遇到的参数拆分问题并非subprocess模块本身导致——当用列表形式传递参数时，subprocess会将每个元素作为完整参数传递。问题出在批处理/Shell脚本的参数解析逻辑：Windows批处理默认会将等号视为参数分隔符，部分Linux脚本若未做特殊处理也可能出现类似情况。

解决办法 #

1. Windows批处理场景 #

修改Python代码，给带等号的参数外层添加引号，同时在批处理脚本中用%~1去除引号，确保获取完整参数：

修改后的Python脚本

import subprocess

# 给参数添加双引号，作为单个元素传入
pa=['test.bat', '"--param:abc=def"']
subprocess.run(pa)

修改后的test.bat脚本

@echo off
echo Test.bat
echo Arg0: %0
echo Arg1: %~1  # 用%~1去除参数外层的引号
echo Arg2: %2
pause

执行后输出会变为：

Test.bat
Arg0: test.bat
Arg1: --param:abc=def
Arg2:
Press any key to continue . . .

2. Linux Shell脚本场景 #

正常情况下，Bash/Sh会将--param:abc=def作为完整参数，直接用列表形式传递即可：

Python脚本

import subprocess

pa=['./test.sh', '--param:abc=def']
subprocess.run(pa)

test.sh脚本

#!/bin/bash
echo Test.sh
echo Arg0: $0
echo Arg1: $1
echo Arg2: $2

执行后$1会完整获取--param:abc=def，不会拆分。

3. 通用替代方案（跨平台） #

若上述方法不适用，可使用shell=True参数，将整个命令作为字符串传递（注意：若参数包含不可信输入，此方法存在命令注入风险）：

import subprocess

# Windows
subprocess.run('test.bat "--param:abc=def"', shell=True)

# Linux
subprocess.run('./test.sh "--param:abc=def"', shell=True)

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