介绍 Python argparse 模块的使用方法。涵盖基础工作流程、核心参数配置（类型、默认值、必填、枚举、动作等）、位置参数与可选参数区别、开关参数及变量重命名。包含 PyCharm 配置技巧及常见避坑指南，通过多个实战案例展示如何构建规范的命令行工具。
在 Python 开发中，命令行参数解析是自动化脚本、批量处理程序的核心能力。argparse作为 Python 内置的标准模块，能替代繁琐的 sys.argv 手动解析，提供标准化、易维护的参数处理方案。
| 特性 | 说明 |
|---|---|
| 开箱即用的帮助体系 | 运行 -h/--help 自动生成参数说明，无需手写文档 |
| 强类型校验 | 自动校验字符串、整数、枚举值等，传错参数直接抛出友好错误 |
| 灵活的参数配置 | 支持位置参数、可选参数、必填参数、默认值、参数缩写等 |
| 工程化规范 | 符合 Python PEP 编码规范，代码可读性与可维护性远超手动解析 |
使用 argparse 只需四步，是所有案例的通用框架：
import argparse # 1. 创建参数解析器（容器）
parser = argparse.ArgumentParser(description="程序功能描述")
# 2. 向解析器中添加参数（定义规则）
parser.add_argument("param_name", config_item1, config_item2, ...)
# 3. 解析命令行传入的参数（执行解析）
args = parser.parse_args()
# 4. 使用参数（业务逻辑）
print(args.param_name)
add_argument() 方法常用参数如下：
| 参数 | 作用 | 示例 |
|---|---|---|
name or flags | 参数名（可选参数需加 --） | '--name', '-n' |
type | 参数类型（int, str, float 等） | type=int |
help | 参数说明（-h 时显示） | help='请输入年龄' |
default | 默认值（不传参时使用） | default='medium' |
required | 是否为必填 | required=True |
choices | 限定可选值列表 | choices=['张三','李四'] |
action | 特殊动作（如开关参数） | action='store_true' |
dest | 指定代码中使用的变量名 | dest='img_path' |
目标：定义 --name（字符串）、--age（整数）参数，输出个性化问候。
import argparse
parser = argparse.ArgumentParser(description="基础案例：接收姓名和年龄并输出问候语")
parser.add_argument('--name', type=str, help='请输入你的姓名（字符串类型）')
parser.add_argument('--age', type=int, help='请输入你的年龄（整数类型）')
args = parser.parse_args()
if args.name and args.age:
print(f"Hello {args.name}, you are {args.age} years old!")
运行演示：
关键细节说明：
type 参数强制限定输入类型，若传入 --age twenty 会报类型错误。help 字符串会在 -h 时自动显示，帮助用户理解参数含义。None，代码中需要做存在性检查（如 if args.name）。目标：定义 -gf/--girlfriend 参数，仅允许传入指定枚举值（Lily / Eva）。
import argparse
parser = argparse.ArgumentParser(description="参数缩写 + 可选值限制案例")
parser.add_argument('-gf', '--girlfriend', choices=['Lily', 'Eva'], help='选择女朋友（仅支持：Lily/Eva）')
args = parser.parse_args()
print(f'选中的女朋友：{args.girlfriend}')
运行演示：
关键细节说明：
--girlfriend，缩写为 -gf，命令行中两者等效。args.girlfriend，不能使用 args.gf（dest 默认取自第一个长选项名或第一个选项去除短横）。choices 限制可选值，传入列表外的值会立即报错，无需手动校验。None，可根据需要设置 default。目标：定义 food、color 两个位置参数（必填），--size/-s 可选参数（带默认值）。
import argparse
parser = argparse.ArgumentParser(description="位置参数 + 默认值案例")
parser.add_argument('food', help='喜欢的食物（位置参数 1，必填）')
parser.add_argument('color', help='喜欢的颜色（位置参数 2，必填）')
parser.add_argument('--size', '-s', default='medium', help='尺寸（默认：medium，可选：small/large）')
args = parser.parse_args()
print(f"食物：{args.food}，颜色：{args.color}，尺寸：{args.size}")
运行演示：
关键细节说明：
- 或 -- 前缀，必须按顺序传入，且为必填（除非设置 nargs='?' 等特殊用法）。--size 带有默认值，不传参时自动使用 default。目标：定义 -f/--food 参数为必填项，强制用户传入食物名称。
import argparse
parser = argparse.ArgumentParser(description="必填参数案例")
parser.add_argument('-f', '--food', type=str, required=True, help='【必填】你喜欢的食物')
args = parser.parse_args()
print(f"你选择的食物：{args.food}")
运行演示：
关键细节说明：
required=True 仅适用于可选参数（带 -/-- 的参数），将其变为'必须通过名称指定'的必填项。required。目标：定义 --house 参数，限制为整数类型，并设置默认值为 0
import argparse
parser = argparse.ArgumentParser(description="默认值 + 类型限制案例")
parser.add_argument('--house', type=int, default=0, help='房屋数量（整数，默认 0）')
args = parser.parse_args()
print(f"房屋数量：{args.house}")
运行演示：
关键细节说明：
type 用于指定默认类型。type=int 自动将输入字符串转为整数，转换失败时报错。default 用于指定默认值，如果在命令行中不指定参数值，则会使用该参数默认值default=0 使参数成为可选参数，不传参时值为 0。default 的参数，不会因为不传参而报错，这与 required=True 形成对比。目标：定义 --debug 开关参数，无需传值，仅通过'是否传入'控制逻辑。
import argparse
parser = argparse.ArgumentParser(description="开关参数案例：调试模式控制")
parser.add_argument('--debug', action='store_true', help='开启调试模式（不传则关闭）')
args = parser.parse_args()
if args.debug:
print("✅ 调试模式已开启，输出详细日志...")
else:
print("🔴 正常运行模式，仅输出核心信息...")
运行演示：
关键细节说明：
action='store_true':若在命令行中未指定该参数，默认状态下其值为 False；若指定该参数，该参数将置为 Trueaction='store_false':若在命令行中未指定该参数，默认状态下其值为 True；若指定该参数，该参数将置为 False目标：参数名用 --img-path，代码中通过 args.img 调用（简化变量名）。
import argparse
parser = argparse.ArgumentParser(description="重定义参数变量名案例")
parser.add_argument('--no_warmup', dest='warmup', action='store_false')
args = parser.parse_args()
print(args.warmup)
运行演示：
关键细节说明：
dest 用于给参数重起一个变量名--no_warmup 传参args.warmup，使用 args.no_warmup 会报错新手常遇到'PyCharm 直接运行报参数缺失'的问题，只需 3 步配置：
--name 张三 --age 25）；
--）必须写在可选参数（--xxx）前面；--age 传入字符串（'二十'）会直接报错，需确保类型一致；-t/--template）不能多次 add_argument，否则报冲突；--path "D:/我的文件/test.png"）；default 配置的值；dest 指定的名称（默认是长选项名去掉 --），而不是缩写。import argparse
parser = argparse.ArgumentParser(
description="综合案例：argparse 全功能演示",
epilog="示例用法：python demo_all.py 苹果 红色 -gf Lily --age 28 --debug -s large"
)
# 位置参数
parser.add_argument('food', help='喜欢的食物（必填）')
parser.add_argument('color', help='喜欢的颜色（必填）')
# 可选参数（缩写 + 可选值）
parser.add_argument('-gf', '--girlfriend', choices=['Lily', 'Eva'], help='女朋友（可选：Lily/Eva）')
# 可选参数（类型 + 默认值）
parser.add_argument('--age', type=int, help='年龄（整数）')
parser.add_argument('--size', '-s', default='medium', help='尺寸（默认 medium）')
# 开关参数
parser.add_argument('--debug', action='store_true', help='开启调试模式')
# 类型 + 默认值示例
parser.add_argument('--house', type=int, default=0, help='房屋数量（默认 0）')
args = parser.parse_args()
# 输出所有参数
print("===== 传入参数汇总 =====")
print(f"食物：{args.food}")
print(f"颜色：{args.color}")
print(f"女朋友：{args.girlfriend if args.girlfriend else '未指定'}")
print(f"年龄：{args.age if args.age else '未指定'}")
print(f"尺寸：{args.size}")
print(f"调试模式：{'开启' if args.debug else '关闭'}")
print(f"房屋数量：{args.house}")
argparse 是 Python 处理命令行参数的标准方案，核心知识点可总结为：
--，必填）、可选参数（--xxx，可选）；type（类型）、help（说明）、required（必填）、choices（可选值）、default（默认值）、action='store_true'（开关）、dest（重命名）；-h 查看帮助，PyCharm 配置参数避免终端操作；dest），缩写仅用于命令行。掌握 argparse 能让你的 Python 程序脱离'硬编码'，适配不同场景的参数输入，是自动化脚本、深度学习训练脚本开发的必备技能。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online