0

0

Python脚本参数化运行_argparse模块详解【教程】

冰川箭仙

冰川箭仙

发布时间:2025-12-25 22:03:21

|

505人浏览过

|

来源于php中文网

原创

argparse.argumentparser() 初始化时通常无需传 prog,但封装为命令行工具时应显式指定以修正 help 中的程序名;布尔参数优先用 'store_true',除非需三态;位置参数须置于可选参数之前;通过 type 和 default 配合 help 可显示类型与默认值。

python脚本参数化运行_argparse模块详解【教程】

argparse.ArgumentParser() 初始化时要不要传 prog

默认情况下,argparse.ArgumentParser() 会自动从 sys.argv[0] 推断程序名,多数时候够用。但如果你的脚本被封装成命令行工具(比如通过 entry_points 注册为 mytool),而实际执行的是某个内部模块,help 里却显示 python -m mypackage.cli,就容易误导用户。

这时显式传入 prog='mytool' 能让帮助信息更准确:

parser = argparse.ArgumentParser(prog='mytool', description='A fast file processor')

注意:它只影响 help 输出和错误提示中的程序名,不影响参数解析逻辑。

add_argument() 的 action 值选 'store_true' 还是 'store_const'

两者都用于布尔型开关,但行为不同:

立即学习Python免费学习笔记(深入)”;

  • 'store_true':遇到该参数就设为 True,没出现就是 False(默认值)
  • 'store_const':必须配合 const=... 使用,适合多开关共用一个变量,比如 --verbose--quiet 都写进同一个 verbosity 字段

常见误用:想实现「有参数就开,没参数就关」却用了 store_const 却忘了给 const,结果参数存在时值仍是 None

推荐优先用 store_true,除非你明确需要三态(如 0/1/2 日志级别):

parser.add_argument('--debug', action='store_true', help='Enable debug logging')

位置参数和可选参数混用时,为什么 parse_args() 报错说 “unrecognized arguments”?

典型原因是:位置参数写在了可选参数后面,而用户又漏写了某个必需的位置参数,导致后续看起来像参数的字符串被当成未知参数处理。

Python精要参考 pdf版
Python精要参考 pdf版

这本书给出了一份关于python这门优美语言的精要的参考。作者通过一个完整而清晰的入门指引将你带入python的乐园,随后在语法、类型和对象、运算符与表达式、控制流函数与函数编程、类及面向对象编程、模块和包、输入输出、执行环境等多方面给出了详尽的讲解。如果你想加入 python的世界,David M beazley的这本书可不要错过哦。 (封面是最新英文版的,中文版貌似只译到第二版)

下载

例如:

parser.add_argument('input_file')
parser.add_argument('--output', '-o')
# 用户运行:python script.py --output result.txt
# → 缺少 input_file,但 argparse 不会报 “missing required argument”,而是把 --output 当成位置参数、result.txt 当成下一个位置参数,最后发现 --output 已定义,却没匹配上,报 unrecognized

解决方法

  • 把所有位置参数放在 add_argument() 调用的最前面
  • 对必需参数,显式加 required=True(仅对可选参数有效)或用 nargs 控制数量
  • 调用 parse_args() 前先检查 len(sys.argv) ,提前提示用法

怎么让 --help 显示更清晰的类型提示和默认值?

默认 help 不显示类型和默认值,用户得看源码猜。加两个参数就能改善:

  • type=strtype=int:会在 help 里显示 [type: str]
  • default=...:配合 help='... (default: %(default)s)',自动填充默认值

注意:如果 defaultNone 或未设,默认值不会显示;空字符串 '' 会被正常渲染。

示例:

parser.add_argument('--port', type=int, default=8000,
                   help='Server port (default: %(default)s)')

输出 help 时会显示:--port PORT Server port (default: 8000)

argparse 的坑往往不在语法,而在“默认行为”和“用户直觉”的错位——比如位置参数顺序、help 文本里的默认值是否可见、布尔参数没出现时的初始状态。这些细节不报错,但会让脚本在真实协作中反复被问“为什么我加了 --xxx 没生效”。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

562

2023.09.20

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

760

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1566

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

649

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

1228

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

1184

2024.04.29

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

192

2025.07.29

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

76

2026.03.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 4.9万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号