在开发 Python 脚本时，命令行参数的解析是一个常见而又重要的操作。无论是处理用户输入的文件路径，还是接受参数配置，argparse 都能轻松帮你搞定。

如果你还不熟悉 argparse，本文将带你一步步掌握！

argparse 简介

argparse 是 Python 标准库中的模块，专门用于解析命令行参数，它让你可以轻松处理命令行输入，并根据用户输入执行不同的操作。

常见应用场景：

• 配置脚本：接收不同的参数来执行不同的操作。
• 程序优化：通过命令行传递配置参数，避免硬编码。
• 
  

基本用法：命令行参数的定义与解析

学习本来就不是一蹴而就的事，不过只要你肯练、敢用，坚持一阵子，你一定能看到变化！

首先，我们来看看最简单的命令行参数解析。我们定义了一个参数 --name 和 --age，来接收用户输入的名字和年龄。

示例代码：

#!/usr/bin/env python
# -*- coding: UTF-8 -*-
"""
@Project ：Fish
@File    ：D12.py
@Date    ：2025/4/24
@Author  : malijie
"""
import argparse

# 创建解析器
parser = argparse.ArgumentParser(description="输入你的个人信息")
parser.add_argument('--name', type=str, help="输入你的名字")
parser.add_argument('--age', type=int, help="输入你的年龄")

# 解析命令行参数
args = parser.parse_args()

# 打印结果
print(f"你好，{args.name}，你的年龄是 {args.age}")

执行示例：

$ python your_script.py --name "Jay" --age 25
你好，Jay，你的年龄是 25

高级用法：必选参数与默认值

除了简单的命令行参数，argparse 还支持必选参数、默认值和不同类型的参数。

示例 1：必选参数

#!/usr/bin/env python
# -*- coding: UTF-8 -*-
"""
@Project ：Fish
@File    ：D12.py
@Date    ：2025/4/24
@Author  : malijie
"""
import argparse

# 创建解析器
parser = argparse.ArgumentParser(description="计算两个数字的和")
parser.add_argument('num1', type=int, help="第一个数字")
parser.add_argument('num2', type=int, help="第二个数字")

# 解析命令行参数
args = parser.parse_args()

# 计算和并输出
print(f"{parser.description}：{args.num1} + {args.num2} = {args.num1 + args.num2}")

执行示例：

我们少传个参数看看：

常用技巧：添加帮助信息和参数类型

argparse 不仅能帮你解析参数，还能自动生成帮助信息，指导用户如何使用你的脚本。

示例 2：自动生成帮助信息

import argparse

# 创建解析器
parser = argparse.ArgumentParser(description="计算两数之和")
parser.add_argument('num1', type=int, help="第一个数字")
parser.add_argument('num2', type=int, help="第二个数字")

# 解析命令行参数
args = parser.parse_args()

# 计算和并输出
print(f"{args.num1} + {args.num2} = {args.num1 + args.num2}")

执行 python D12.py --help 后，自动显示帮助信息：

argparse 进阶技巧：互斥参数与可选参数

有时你可能需要设置互斥的参数，确保同一时间只能传递其中一个参数。例如，我们不希望用户同时传递 --name 和 --age。

示例 3：互斥参数

#!/usr/bin/env python
# -*- coding: UTF-8 -*-
"""
@Project ：Fish
@File    ：D12.py
@Date    ：2025/4/24
@Author  : malijie
"""
import argparse

# 创建解析器
parser = argparse.ArgumentParser(description="输入你的名字或者年龄")
group = parser.add_mutually_exclusive_group(required=True)
group.add_argument('--name', type=str, help="输入你的名字")
group.add_argument('--age', type=int, help="输入你的年龄")

# 解析命令行参数
args = parser.parse_args()

# 输出结果
if args.name:
    print(f"你的名字是 {args.name}")
else:
    print(f"你的年龄是 {args.age}")

执行示例：

总结：argparse 模块的核心能力

1. 基本参数解析：支持必选参数和可选参数的解析。
2. 帮助信息：自动生成帮助信息，提升用户体验。
3. 互斥组：确保在命令行中使用互斥的参数。
4. 默认值：为参数指定默认值。

使用场景：什么时候用 argparse？

• 自动化脚本：你可以通过命令行传递参数控制脚本行为。
• 配置管理：传递配置文件路径、设置调试级别等。
• 数据处理：为数据分析脚本提供输入参数。

下期预告：numpy 数值运算，超高性能的数据处理工具！

点关注点赞不迷路，后续更新更多自动化测试经验，我们一起成长！

欢迎评论区留言你最常用的 argparse 场景或踩过的坑～

点击头像查看往期精彩文章！