【argparse，一个易用的 Python 库！】

在日常编写 Python 脚本、开发工具、运行自动化程序时，我们经常需要让程序接收外部传入的参数：比如运行脚本时指定文件名、切换运行模式、设置端口号、传入配置路径等。如果手动读取sys.argv，代码繁琐、容易出错、参数解析混乱，也无法生成帮助提示。argparse 是 Python 官方内置的命令行参数解析库，专门用于优雅、规范、快速地处理命令行输入，无需复杂逻辑，几行代码就能实现参数定义、类型校验、默认值设置、帮助文档自动生成，让 Python 脚本像专业工具一样支持命令行交互使用。它大幅提升脚本的灵活性、复用性和易用性，是编写命令行工具、自动化脚本、后台任务程序的必备库，也是 Python 开发者从 “写简单脚本” 升级为 “写专业工具” 的核心技能。

一、库的简介：实际生活中的核心作用

argparse 是 Python 内置标准库，专门用于解析命令行参数，让程序可以接收外部输入的配置、指令、路径、开关等信息。在实际生活与开发中，它的用处无处不在：编写数据处理脚本时传入文件路径；运行爬虫时指定爬取页数；启动服务时设置端口号；执行定时任务时切换运行环境；制作小工具时开启调试模式。它能自动处理参数类型、必填校验、默认值、可选参数等逻辑，还能自动生成-h帮助文档，让你的脚本像官方工具一样专业易用，彻底告别硬编码、手动参数判断和杂乱的输入处理，让程序更灵活、更通用、更便于他人使用。

二、安装库

argparse 是 Python 官方内置库，完全不需要安装，安装 Python 后即可直接导入使用，跨平台、无依赖、开箱即用。

三、基本用法（分 4 个核心步骤）

步骤 1：导入库

直接导入内置 argparse 模块，一般重命名为便于使用的简写：

python

运行

# 导入内置命令行参数解析库
import argparse

步骤 2：创建参数解析器对象

初始化解析器，设置程序描述信息：

python

运行

# 创建解析器实例
parser = argparse.ArgumentParser(description="这是一个命令行参数演示程序")

步骤 3：添加需要的参数

定义参数名称、类型、默认值、帮助信息：

python

运行

# 添加必选参数
parser.add_argument("--name", type=str, required=True, help="输入你的名字")
# 添加可选参数（带默认值）
parser.add_argument("--age", type=int, default=18, help="输入你的年龄，默认18")

步骤 4：解析参数并使用

解析命令行输入，在程序中直接使用参数：

python

运行

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

# 使用参数
print(f"你好，{args.name}！你的年龄是：{args.age}")

运行方式：

bash

运行

python test.py --name 小明 --age 20

四、高级用法

argparse 支持丰富的高级功能，满足专业工具需求：

1. 开关参数：布尔类型参数，无需传值，使用则开启；
2. 参数选择范围：限制参数只能输入指定值；
3. 子命令：支持多模式指令，类似 git 的 add/commit/push；
4. 互斥参数：同一时间只能使用其中一个参数；
5. 列表参数：支持传入多个值，自动解析为列表。

高级用法示例（开关参数 + 范围限制）：

python

运行

import argparse

parser = argparse.ArgumentParser()
# 开关参数
parser.add_argument("--debug", action="store_true", help="开启调试模式")
# 范围选择参数
parser.add_argument("--mode", choices=["dev", "prod"], default="dev", help="运行模式")

args = parser.parse_args()
print("调试模式：", args.debug)
print("运行模式：", args.mode)

五、实际应用场景

argparse 通用性极强，覆盖日常开发所有命令行场景：

1. 自动化脚本：传入文件路径、日期、配置项；
2. 爬虫工具：指定爬取网址、页数、线程数、输出格式；
3. 数据处理：输入源文件、输出格式、清洗规则；
4. 后台服务：设置端口、环境、日志级别、工作路径；
5. 个人工具：制作计算器、转换器、批量处理工具，提升复用性。

---

深度案例代码：命令行文件批量重命名工具（完整可运行）

python

运行

import argparse
import os

def batch_rename(path, prefix, ext):
    """批量重命名文件"""
    count = 0
    for filename in os.listdir(path):
        old_path = os.path.join(path, filename)
        if os.path.isfile(old_path):
            new_name = f"{prefix}_{count}.{ext}"
            new_path = os.path.join(path, new_name)
            os.rename(old_path, new_path)
            count += 1
    print(f"重命名完成，共处理 {count} 个文件")

if __name__ == "__main__":
    parser = argparse.ArgumentParser(description="批量文件重命名工具")
    parser.add_argument("--path", required=True, help="文件所在文件夹路径")
    parser.add_argument("--prefix", default="file", help="文件名前缀")
    parser.add_argument("--ext", default="txt", help="目标文件后缀")
    
    args = parser.parse_args()
    batch_rename(args.path, args.prefix, args.ext)

运行示例：

bash

运行

python rename.py --path ./test --prefix photo --ext jpg

argparse 作为 Python 官方内置的命令行参数解析神器，以简洁、易用、稳定的特点，成为编写命令行工具和自动化脚本的首选。它让程序可以灵活接收外部输入，告别硬编码，同时自动生成专业帮助文档，大幅提升脚本的实用性与规范性。无论是简单小脚本还是复杂工具，argparse 都能以最低成本实现最高效的参数解析，是 Python 开发者提升代码质量与工作效率的必备库。

看完这篇文章，你已经掌握 argparse 从基础到实战的全部用法，它能让你写的脚本更专业、更灵活、更易用。你平时写 Python 脚本时最需要传入什么参数呢？不妨用 argparse 快速改造一下，让你的脚本真正变成可复用、可分享的专业工具。