argparse中如何实现通用共享参数可在子解析器参数前后任意位置生效？

我刚好踩过类似的坑，来帮你捋清楚怎么搞定这个问题！

首先先拆解你遇到的两个核心问题：

• 直接在主解析器加共享参数时，参数只能放在子命令前面，放在子命令后面就报错（比如drink water --say thanks），这是因为argparse默认会严格区分主解析器参数和子解析器参数的位置——主参数必须在子命令之前。
• 你用parents参数时出错，是因为把包含subparsers的主解析器传给了子解析器，导致子解析器也继承了subparsers选项。输入eat apple时，子解析器会把apple当成要选择的子命令（eat/drink），自然就报invalid choice了。

正确解决方案：单独抽离共享参数的父解析器 #

我们需要把共享参数单独放在一个独立的父解析器里，让主解析器和所有子解析器都继承这个父解析器，这样不管共享参数放在子命令的前面还是后面，都能被正确识别。

具体代码如下：

from argparse import ArgumentParser

# 1. 创建只存共享参数的父解析器（add_help=False避免重复生成-h参数）
parent_parser = ArgumentParser(add_help=False)
parent_parser.add_argument('--say')
parent_parser.add_argument('--clap')  # 你提到的第二个共享参数

# 2. 创建主解析器，继承父解析器后再添加子解析器
main_parser = ArgumentParser(parents=[parent_parser])
subparsers = main_parser.add_subparsers(dest='action', required=True, help='what should I do')

# 3. 每个子解析器都继承父解析器，再添加自己的专属参数
eat_parser = subparsers.add_parser('eat', parents=[parent_parser])
eat_parser.add_argument('food')

drink_parser = subparsers.add_parser('drink', parents=[parent_parser])
drink_parser.add_argument('beverage')

# 测试你需要的所有命令行场景
print(main_parser.parse_args(['eat', 'apple', '--say', 'thanks']))
print(main_parser.parse_args(['--say', 'grace', 'drink', 'coffee']))
print(main_parser.parse_args(['--say', 'grace', 'eat', 'bread', '--clap', 'hands']))

运行结果验证 #

执行代码后，会得到符合预期的输出：

Namespace(action='eat', clap=None, food='apple', say='thanks')
Namespace(action='drink', clap=None, beverage='coffee', say='grace')
Namespace(action='eat', clap='hands', food='bread', say='grace')

为什么这个方法可行？ #

• 父解析器只负责共享参数，没有子解析器逻辑，所以子解析器继承后不会出现重复的subparsers选项。
• 主解析器继承父解析器，支持共享参数放在子命令前面；子解析器也继承父解析器，支持共享参数放在子命令后面。argparse会自动识别这些参数属于共享定义，不受位置限制。

另外注意：Python 3.7+版本中，subparsers的required=True是必要的（如果你要求用户必须指定子命令），否则只输入共享参数时会报错。

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