argparse 是 Python 标准库中用于解析命令行参数的模块，它使得编写用户友好的命令行界面变得简单易行。以下将详细介绍 argparse 的使用方法，并通过实例演示其应用。

一、基本使用步骤

1、导入模块

python">import argparse

2、创建 ArgumentParser 对象

python">parser = argparse.ArgumentParser(description='描述程序的用途')

description 参数用于描述程序的用途，当用户使用 -h 或 --help 参数时会显示该描述。

3、添加参数

python">parser.add_argument('参数名', help='参数的帮助信息')

add_argument() 方法用于添加命令行参数。
help 参数用于描述该参数的用途。

4、解析参数

python">args = parser.parse_args()

parse_args() 方法用于解析命令行参数，并将结果存储在 args 对象中。

5、使用参数

python">print(args.参数名)

可以通过 args.参数名 的方式访问解析后的参数值。

二、参数类型

add_argument() 方法支持多种参数类型，以下是一些常用的类型：

位置参数 (Positional arguments): 必须提供的参数，顺序固定。

python">parser.add_argument('filename', help='输入文件名')

可选参数 (Optional arguments): 以 - 或 – 开头的参数，顺序不固定。

python">parser.add_argument('-v', '--verbose', help='显示详细信息', action='store_true')

action=‘store_true’ 表示如果指定了该参数，则值为 True，否则为 False。

带值的可选参数:

python">parser.add_argument('-o', '--output', help='输出文件名', type=str)

type 参数用于指定参数值的类型，例如 str, int, float 等。

三、常用参数选项

help: 参数的帮助信息。
type: 参数值的类型。
default: 参数的默认值。
choices: 参数值的可选范围。
required: 参数是否必须提供。
action: 参数的动作，例如 store_true, store_false, append 等。

四、实例演示

argparse__70">4.1 使用 argparse 解析命令行参数

以下是一个简单的示例，演示如何使用 argparse 解析命令行参数：

python">import argparse# 创建 ArgumentParser 对象
parser = argparse.ArgumentParser(description='计算两个数的和')# 添加位置参数
parser.add_argument('num1', type=int, help='第一个数字')
parser.add_argument('num2', type=int, help='第二个数字')# 添加可选参数
parser.add_argument('-v', '--verbose', help='显示详细信息', action='store_true')# 解析参数
args = parser.parse_args()# 使用参数
result = args.num1 + args.num2if args.verbose:print(f'{args.num1} + {args.num2} = {result}')
else:print(result)

运行示例：

$ python sum.py 1 2
3$ python sum.py 1 2 -v
1 + 2 = 3

4.2 完整的示例程序

以下是一个完整的示例程序：

python">import argparsedef main():parser = argparse.ArgumentParser(description='这是一个示例程序，用于演示 argparse 的用法')parser.add_argument('name', type=str, help='用户的姓名')parser.add_argument('-a', '--age', type=int, default=18, help='用户的年龄，默认为 18')parser.add_argument('-v', '--verbose', action='store_true', help='增加输出的详细程度')args = parser.parse_args()print(f"Hello, {args.name}!")print(f"You are {args.age} years old.")if args.verbose:print("Verbose mode is enabled.")if __name__ == "__main__":main()

运行这个程序，你可以使用以下命令行参数：

python script.py John -a 25 -v

输出将是：

vbnet
Hello, John!
You are 25 years old.
Verbose mode is enabled.

如果你不提供 age 和 verbose 参数：

python script.py John

输出将是：

vbnet
Hello, John!
You are 18 years old.

五、进阶用法

子命令 (Subcommands): 可以使用 add_subparsers() 方法实现子命令功能，类似于 git commit, git push 等命令。

python">subparsers = parser.add_subparsers(dest='command')# 添加 commit 子命令
commit_parser = subparsers.add_parser('commit', help='提交代码')
commit_parser.add_argument('-m', '--message', help='提交信息', required=True)# 添加 push 子命令
push_parser = subparsers.add_parser('push', help='推送代码')
push_parser.add_argument('--force', help='强制推送', action='store_true')

参数组 (Argument groups): 可以使用 add_argument_group() 方法将相关的参数分组显示。

python">group = parser.add_argument_group('group1')
group.add_argument('--foo', help='foo help')
group.add_argument('--bar', help='bar help')

六、总结

argparse 是 Python 中功能强大且易于使用的命令行参数解析模块。通过掌握其基本用法和进阶技巧，可以轻松构建用户友好的命令行界面，提升程序的易用性和可维护性。