Python argparse入门：把脚本参数与预览模式分清

脚本从临时练习变成日常工具后，输入参数不宜继续靠手工改源码。argparse可以处理参数、帮助信息和错误输入，但预览模式仍要由程序逻辑真正实现。

浅色主题概念配图，选自本站AI生成图库；非事件现场或产品实测截图。

参数先表达用途

示例接受一个必填名称和一个–dry-run开关。store_true让开关出现时为True，未出现时为False。参数名称应让调用者知道它控制什么，而不是用一组不带说明的数字位置。

预览模式必须阻止实际写入

–dry-run只是约定名称，解析器不会自动替你阻止改文件或发送请求。实际工具应先计算计划，再根据该开关决定是否执行有副作用的步骤。本例仅输出预览文字，没有实现任何写入动作。

从固定输入开始检查

为让练习可重复，下面将参数列表显式传给parse_args。真正从终端读取参数时可调用parse_args()；还应检查缺少必填参数和未知参数时的提示。批量操作前先用少量测试数据验证，避免参数拼错就影响真实文件。

可以运行的练习

import argparse
parser = argparse.ArgumentParser(description="展示任务预览")
parser.add_argument("--name", required=True)
parser.add_argument("--dry-run", action="store_true")
args = parser.parse_args(["--name", "练习任务", "--dry-run"])
assert args.dry_run is True
print(f"预览：{args.name}；未执行写入")

示例已在本地隔离环境运行检查。使用固定输入，不访问外部接口，也不读取真实业务文件。