如何用argparse实现grep式混合位置与命名参数模式？

需求 #

实现和grep一致的参数行为：

• 匹配模式支持两种传入方式：作为第一个位置参数，或通过-e/--pattern命名参数传入
• -e参数可重复使用，以此添加多个匹配模式
• 未指定-e时，第一个位置参数为匹配模式，剩余位置参数是目标文件列表；指定-e时，所有位置参数都是目标文件

踩坑记录 #

尝试直接定义兼具位置与命名属性的参数时，比如parser.add_argument('pattern', '-e', '--pattern')，会触发报错：pattern must start with '-'——argparse不允许单个参数同时被定义为位置参数和命名参数。

可用但帮助信息不符的实现 #

以下代码能实现核心逻辑，但自动生成的用法、帮助信息和程序实际行为不匹配：

import argparse

parser = argparse.ArgumentParser()
parser.add_argument('-e', '--pattern', action='append')
parser.add_argument('positional', nargs='+')
args = parser.parse_args()

# 处理模式与文件列表
patterns = args.pattern or [args.positional[0]]
files = args.positional[(not args.pattern):]
# 确保存在目标文件
assert len(files) > 0, "必须指定至少一个目标文件"

问题点 #

这段代码的帮助信息会将positional描述为“必填的多个位置参数”，但实际逻辑中positional的含义会根据是否使用-e发生变化，无法通过自动生成的帮助信息准确传达。

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