Python脚本参数接收_sys与argparse解析【指导】

sys.argv适合简单场景,argparse更适合正式项目;前者仅提供原始参数列表,需手动解析和校验,后者支持自动帮助、类型检查、默认值及子命令等高级功能。

Python脚本接收命令行参数,sys.argv适合简单场景,argparse更适合正式项目——它自动处理帮助信息、类型校验、参数组合和错误提示。

sys.argv 快速获取原始参数

sys.argv 是一个列表,argv[0] 是脚本名,后续元素是传入的字符串参数。它不解析结构,也不做类型转换,适合写一次性小工具或调试时快速取值。

  • 直接访问索引即可:比如 python script.py input.txt -v 中,sys.argv[1]"input.txt"sys.argv[2]"-v"
  • 需手动判断参数是否存在、是否符合预期格式,否则容易触发 IndexError 或类型错误
  • 不支持 --help、默认值、选项分组等特性,也不校验参数合法性

argparse 规范化定义和解析参数

argparse 是 Python 标准库中推荐的参数解析模块,适用于需要可维护性、可读性和用户友好性的脚本。

  • 声明式定义参数:用 add_argument() 明确指定名称、类型(type=int)、是否必需(required=True)、默认值(default="log.txt")等
  • 自动支持短选项(-f)、长选项(--file)、位置参数、可选参数、互斥组(add_mutually_exclusive_group()
  • 调用 parser.parse_args() 后返回命名空间对象,属性名即参数名(如 args.input),无需索引操作
  • 输入 --help 或参数错误时,自动输出清晰的帮助文本,无需额外编码

常见搭配与实用技巧

实际使用中,常结合两者优势或补充功能:

  • 位置参数 + 可选参数混合:例如 python convert.py source.json --output target.yaml --format yaml
  • 支持子命令:用 add_subparsers() 实现类似 git commitgit push 的多模式脚本
  • 从配置文件或环境变量回退:argparse 解析后,可用 os.getenv()configparser 做兜底
  • 自定义类型函数:传入 type=valid_date,在解析阶段就校验日期格式并抛出易懂错误

什么时候该选哪个?

判断依据主要是脚本用途和协作需求:

  • 单人临时脚本、测试用例、CI 中简单调用 → sys.argv 足够轻量
  • 要交付给他人、需文档化、可能频繁更新参数、涉及多个选项组合 → 必须用 argparse
  • 已有老脚本用 sys.argv,但开始出现 if len(sys.argv) 这类硬编码判断 → 是重构为 argparse 的明确信号