如何使用Argparse模块解析Python脚本的长尾输入参数？

本文共计759个文字，预计阅读时间需要4分钟。

在Python中使用`argparse`解析命令行参数，核心是创建一个`ArgumentParser`实例，定义参数，然后调用`parse_args()`获取结果。这比手动处理`sys.argv`更健壮、易读，还能自动生成帮助信息。

基础用法：定义位置参数和可选参数

位置参数（必填）不带短横线，可选参数（可选）通常以 - 或 -- 开头：

• 用 add_argument("name") 添加位置参数（如文件路径）
• 用 add_argument("-f", "--file", ...) 添加可选参数，支持短名和长名
• 常用参数：help=（说明）、type=（自动转类型，如 int）、default=（默认值）、required=（是否必填）

示例：

import argparse parser = argparse.ArgumentParser(description="处理文本文件") parser.add_argument("input_file", help="输入文件路径") parser.add_argument("-o", "--output", help="输出文件路径") parser.add_argument("-n", "--lines", type=int, default=10, help="显示前几行") args = parser.parse_args() print(f"输入: {args.input_file}") print(f"输出: {args.output}") print(f"行数: {args.lines}")

运行 python script.py data.txt -n 5 就会把 data.txt 赋给 args.input_file，5 赋给 args.lines。

立即学习“Python免费学习笔记（深入）”；

处理布尔开关和多值参数

开关类参数（如 --verbose）适合用 action="store_true"；接收多个值用 nargs=：

• add_argument("--verbose", action="store_true") → 出现即为 True，否则 False
• add_argument("--tags", nargs="+") → 接收至少一个值，如 --tags py js ts → ["py", "js", "ts"]
• add_argument("--mode", choices=["fast", "safe", "debug"]) → 限制合法取值

子命令（subparsers）：类似 git add / git commit

当脚本有多个功能入口时，可用子解析器区分逻辑：

• 先调用 parser.add_subparsers(dest="command")
• 为每个子命令创建独立的 add_parser()，再为其添加专属参数
• 解析后通过 args.command 判断执行哪个分支

例如定义 upload 和 download 两个子命令，各自可有不同参数，互不干扰。

错误处理与帮助信息

argparse 默认在参数错误或传入 -h/--help 时自动退出并打印帮助。如需自定义错误行为（比如不退出），可捕获 SystemExit，但一般不建议——它的默认行为已足够友好且符合 CLI 惯例。确保每个参数都有清晰的 help 字符串，用户执行 -h 就能一目了然。