subprocess.run()执行时误将参数当作子命令运行的问题排查

1. 修正argparse子命令配置 #

核心问题是你的argparse把message识别成了独立子命令，而非log的参数。要给log子命令显式添加位置参数：

import argparse
import subprocess

# 初始化主解析器
parser = argparse.ArgumentParser(prog='mds')
# 必须设置dest，否则无法获取选中的子命令
subparsers = parser.add_subparsers(dest='sub_cmd', required=True)

# 配置log子命令，添加message参数
log_parser = subparsers.add_parser('log')
log_parser.add_argument('message', help='要记录的日志内容')

# 解析参数
args = parser.parse_args()

# 分支执行对应脚本
if args.sub_cmd == 'log':
    # 仅执行log.py，并把message作为参数传递
    subprocess.run(['python', 'log.py', args.message], check=True)

2. 排查subprocess调用逻辑 #

避免循环遍历所有输入参数来执行脚本的错误写法。比如以下错误代码会导致log和message都被当成脚本执行：

# 错误示例：不要这么写
for item in sys.argv[1:]:
    subprocess.run(['python', f'{item}.py'])

必须根据解析后的子命令分支处理，只执行对应脚本并传递参数。

3. 验证参数解析结果 #

在代码中加入打印语句，确认argparse的解析结果是否符合预期：

print(args)

执行mds log test后，正确输出应为Namespace(sub_cmd='log', message='test')，如果message被识别为独立子命令，说明子命令配置有误。

4. 规范subprocess参数传递 #

调用subprocess时，用列表形式传递参数，避免shell解析错误：

# 正确写法
subprocess.run(['python', 'log.py', args.message])

# 不推荐的错误写法（易触发参数解析问题）
subprocess.run(f'python log.py {args.message}', shell=True)

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