Python argparse 库命令行参数处理详解

Owen
Owen
发布时间:2026-10-13| 5人浏览过
原创

本文详解 Python 标准库 argparse 的使用方法,涵盖位置参数与选项参数的区别、ArgumentParser 初始化配置、add_argument 参数定义及类型指定。通过代码示例演示如何解析命令行输入,帮助开发者高效构建命令行工具。

argparse 是 Python 标准库中用于处理命令行参数的模块。

命令行参数主要分为两类:位置参数和选项参数。

位置参数是指程序依据参数在命令行中出现的位置来确定其含义的参数。

例如,在命令 [root@openstack_1 /]# ls root/ 中,root/ 即为一个位置参数。

选项参数是应用程序预先定义好的参数,用户不能随意指定名称。

例如,在命令 [root@openstack_1 /]# ls -l 中,-l 是 ls 命令预定义的选项参数。

基本使用示例

import argparse

# 创建解析器
parser = argparse.ArgumentParser(description = 'This is a test')
parser.parse_args()

用户可以在 Shell 环境中进行测试验证。

$ python test.py --help
...

添加参数配置

import argparse

parser = argparse.ArgumentParser(description = 'This is a test')
parser.add_argument("-p","--port",help='increase output port') # 定义了可选参数-p和--port,赋值后,其值保存在args.port中(其值都是保存在最后一个定义的参数中)
args = parser.parse_args()
print(args.echo)

调用 argparse.ArgumentParser() 时,通常只需关注 description 参数,其他参数可根据需要选择。

prog=None:指定程序名称。

description=None:指定在显示帮助信息时开头显示的文字。

epilog=None:指定在显示帮助信息时结尾显示的文字。

parents=[]:若与其他参数配置相同,可通过此参数进行继承。

formatter_class=argparse.HelpFormatter:用于自定义帮助信息的格式。

prefix_chars='-':指定命令的前缀字符,默认为 '-'。

fromfile_prefix_chars=None:若指定,命令行参数可从文件中读取。

argument_default=None:设置全局选项的默认值,通常建议为每个选项单独设置。

conflict_handler='error':定义当两个 add_argument 添加的选项名称发生冲突时的处理方式,默认为抛出异常。

add_help=True:是否添加 -h/--help 选项,默认为 True。

add_argument() 方法的参数配置说明如下:

name or flags...:必选参数,用于指定参数的形式,通常建议同时提供短参数和长参数。

实际使用示例如下:

$ python test.py -p 50
或
$ python test.py --port 50

指定参数类型

在添加参数时,可以明确指定其数据类型。

import argparse

parser = argparse.ArgumentParser(description = 'This is a test')
parser.add_argument("square",help="display a given number",type=int) # 指定给square的参数为int类型

可选参数处理

import argparse
parser = argparse.ArgumentParser()
parser.add_argument("-v", help="increase output verbosity")
args = parser.parse_args()
if args.v:
  print("v turned on")

具体使用方式如下:

$ python test.py -v any

官方文档参考

更多应用场景请参阅百度搜索结果或官方文档:https://docs.python.org/3/library/argparse.html#module-argparse

以上内容为本文的全部介绍,希望能为读者的学习提供有益帮助,同时也欢迎大家继续支持本站。

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。