基于Python3.5+argparse实现支持位置/可选参数的命令行解析需求

针对你在Debian 9（Python 3.5）下的需求，这里有一个符合规则的argparse实现，既支持位置参数模式，也支持-i/-o可选参数模式，同时提供清晰的使用提示：

import argparse

def main():
    # 自定义usage提示，明确展示两种合法使用格式
    parser = argparse.ArgumentParser(
        description='处理输入文件并可选将结果输出到指定文件',
        usage='%(prog)s [-i INPUT] [-o OUTPUT] | %(prog)s INPUT [OUTPUT]'
    )
    
    # 创建互斥组，确保输入文件名只能通过位置参数或-i指定，避免冲突
    input_group = parser.add_mutually_exclusive_group(required=True)
    input_group.add_argument('input', nargs='?', help='输入文件名（位置模式，需在输出前）')
    input_group.add_argument('-i', '--input-file', dest='input', help='输入文件名（可选参数模式）')
    
    # 输出文件名：支持位置模式（紧跟输入）或-o指定
    parser.add_argument('output', nargs='?', help='输出文件名（位置模式，需紧跟输入）')
    parser.add_argument('-o', '--output-file', dest='output', help='输出文件名（可选参数模式）')
    
    args = parser.parse_args()
    
    # 处理业务逻辑示例
    print(f"正在处理输入文件: {args.input}")
    if args.output:
        print(f"结果将输出到: {args.output}")
    else:
        print("未指定输出文件，默认输出到标准输出")

if __name__ == '__main__':
    main()

关键设计说明 #

1. 自定义Usage提示：
   手动指定usage参数，清晰展示两种合法的命令行格式：

   • 要么用-i/-o显式指定参数
   • 要么用位置参数，输入在前、可选输出紧跟
     这样用户一眼就能明白如何正确调用程序。

2. 互斥组保障参数合法性：
   用add_mutually_exclusive_group(required=True)确保输入文件名只能通过一种方式指定（位置参数或-i），避免出现script.py input.txt -i another.txt这种冲突的调用方式，同时保证输入参数是必填项。

3. 输出参数的灵活性：
   输出文件名既可以紧跟在输入位置参数之后，也可以通过-o指定，甚至支持混合模式（比如script.py input.txt -o output.txt），完全符合你提出的规则。

合法命令行示例 #

以下调用方式都是被允许的：

• 仅指定输入（位置模式）：python3 your_script.py data.txt
• 输入+输出（位置模式）：python3 your_script.py data.txt result.txt
• 仅指定输入（可选参数模式）：python3 your_script.py -i data.txt
• 输入+输出（可选参数模式）：python3 your_script.py -i data.txt -o result.txt
• 混合模式（位置输入+可选输出）：python3 your_script.py data.txt -o result.txt

Python 3.5兼容性说明 #

这个实现完全兼容Python 3.5，用到的argparse特性（互斥组、nargs='?'、自定义usage）在Python 3.2及以上版本就已经支持，Debian 9自带的Python 3.5完全没问题。

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