[{"data":1,"prerenderedAt":1073},["ShallowReactive",2],{"post-2026-03-01-argparse-guide":3},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"date":10,"tags":11,"body":14,"_type":1067,"_id":1068,"_source":1069,"_file":1070,"_stem":1071,"_extension":1072},"\u002Fblog\u002F2026-03-01-argparse-guide","blog",false,"","argparse 命令行参数解析工具","Python argparse 标准库使用教程，掌握命令行参数解析、类型转换和自动帮助信息生成。","2026-03-01",[12,13],"Python","命令行",{"type":15,"children":16,"toc":1059},"root",[17,39,45,118,123,128,171,177,409,414,419,431,465,470,495,501,543,547,578,584,613,617,710,716,743,748,762,774,1019,1024,1053],{"type":18,"tag":19,"props":20,"children":21},"element","p",{},[22,30,32,37],{"type":18,"tag":23,"props":24,"children":26},"code",{"className":25},[],[27],{"type":28,"value":29},"text","argparse",{"type":28,"value":31}," 是 Python 标准库中用于解析命令行参数的强大工具，它可以自动处理参数解析、类型转换、生成帮助信息等。以下是使用 ",{"type":18,"tag":23,"props":33,"children":35},{"className":34},[],[36],{"type":28,"value":29},{"type":28,"value":38}," 解析命令行参数的详细步骤和示例。",{"type":18,"tag":40,"props":41,"children":43},"h3",{"id":42},"基本使用步骤",[44],{"type":28,"value":42},{"type":18,"tag":46,"props":47,"children":48},"ol",{},[49,59,77,94,110],{"type":18,"tag":50,"props":51,"children":52},"li",{},[53],{"type":18,"tag":54,"props":55,"children":56},"strong",{},[57],{"type":28,"value":58},"导入 argparse 模块",{"type":18,"tag":50,"props":60,"children":61},{},[62,67,69,75],{"type":18,"tag":54,"props":63,"children":64},{},[65],{"type":28,"value":66},"创建解析器对象",{"type":28,"value":68},"（",{"type":18,"tag":23,"props":70,"children":72},{"className":71},[],[73],{"type":28,"value":74},"ArgumentParser",{"type":28,"value":76},"）",{"type":18,"tag":50,"props":78,"children":79},{},[80,85,86,92],{"type":18,"tag":54,"props":81,"children":82},{},[83],{"type":28,"value":84},"添加参数规则",{"type":28,"value":68},{"type":18,"tag":23,"props":87,"children":89},{"className":88},[],[90],{"type":28,"value":91},"add_argument()",{"type":28,"value":93}," 方法）",{"type":18,"tag":50,"props":95,"children":96},{},[97,102,103,109],{"type":18,"tag":54,"props":98,"children":99},{},[100],{"type":28,"value":101},"解析参数",{"type":28,"value":68},{"type":18,"tag":23,"props":104,"children":106},{"className":105},[],[107],{"type":28,"value":108},"parse_args()",{"type":28,"value":93},{"type":18,"tag":50,"props":111,"children":112},{},[113],{"type":18,"tag":54,"props":114,"children":115},{},[116],{"type":28,"value":117},"使用解析后的参数",{"type":18,"tag":40,"props":119,"children":121},{"id":120},"详细示例",[122],{"type":28,"value":120},{"type":18,"tag":19,"props":124,"children":125},{},[126],{"type":28,"value":127},"假设我们要实现一个脚本，支持接收以下参数：",{"type":18,"tag":129,"props":130,"children":131},"ul",{},[132,145,158],{"type":18,"tag":50,"props":133,"children":134},{},[135,137,143],{"type":28,"value":136},"必选参数：",{"type":18,"tag":23,"props":138,"children":140},{"className":139},[],[141],{"type":28,"value":142},"-n",{"type":28,"value":144},"（数字，如年龄）",{"type":18,"tag":50,"props":146,"children":147},{},[148,150,156],{"type":28,"value":149},"可选参数：",{"type":18,"tag":23,"props":151,"children":153},{"className":152},[],[154],{"type":28,"value":155},"-m",{"type":28,"value":157},"（字符串，如消息）",{"type":18,"tag":50,"props":159,"children":160},{},[161,163,169],{"type":28,"value":162},"标志参数：",{"type":18,"tag":23,"props":164,"children":166},{"className":165},[],[167],{"type":28,"value":168},"-v",{"type":28,"value":170},"（无值，用于开启 verbose 模式）",{"type":18,"tag":172,"props":173,"children":175},"h4",{"id":174},"示例代码",[176],{"type":28,"value":174},{"type":18,"tag":178,"props":179,"children":183},"pre",{"className":180,"code":181,"language":182,"meta":7,"style":7},"language-python shiki shiki-themes github-dark","# demo.py\nimport argparse\n\n# 1. 创建解析器对象，可指定脚本描述\nparser = argparse.ArgumentParser(description=\"这是一个argparse示例脚本，用于演示参数解析\")\n\n# 2. 添加参数规则\n# 添加必选参数 -n（整数类型）\nparser.add_argument('-n', '--number', type=int, required=True, help='必选数字参数（整数），例如年龄')\n\n# 添加可选参数 -m（字符串类型，默认值为\"hello\"）\nparser.add_argument('-m', '--message', type=str, default='hello', help='可选字符串参数（默认值：hello）')\n\n# 添加标志参数 -v（无需值，出现则为True）\nparser.add_argument('-v', '--verbose', action='store_true', help='开启详细输出模式')\n\n# 3. 解析命令行参数\nargs = parser.parse_args()\n\n# 4. 使用解析后的参数\nprint(f\"数字参数: {args.number}（类型：{type(args.number)}）\")\nprint(f\"消息参数: {args.message}（类型：{type(args.message)}）\")\n\nif args.verbose:\n    print(\"详细模式已开启：正在执行额外的日志输出...\")\n","python",[184],{"type":18,"tag":23,"props":185,"children":186},{"__ignoreMap":7},[187,198,207,217,226,235,243,252,261,270,278,287,296,304,313,322,330,339,348,356,365,374,383,391,400],{"type":18,"tag":188,"props":189,"children":192},"span",{"class":190,"line":191},"line",1,[193],{"type":18,"tag":188,"props":194,"children":195},{},[196],{"type":28,"value":197},"# demo.py\n",{"type":18,"tag":188,"props":199,"children":201},{"class":190,"line":200},2,[202],{"type":18,"tag":188,"props":203,"children":204},{},[205],{"type":28,"value":206},"import argparse\n",{"type":18,"tag":188,"props":208,"children":210},{"class":190,"line":209},3,[211],{"type":18,"tag":188,"props":212,"children":214},{"emptyLinePlaceholder":213},true,[215],{"type":28,"value":216},"\n",{"type":18,"tag":188,"props":218,"children":220},{"class":190,"line":219},4,[221],{"type":18,"tag":188,"props":222,"children":223},{},[224],{"type":28,"value":225},"# 1. 创建解析器对象，可指定脚本描述\n",{"type":18,"tag":188,"props":227,"children":229},{"class":190,"line":228},5,[230],{"type":18,"tag":188,"props":231,"children":232},{},[233],{"type":28,"value":234},"parser = argparse.ArgumentParser(description=\"这是一个argparse示例脚本，用于演示参数解析\")\n",{"type":18,"tag":188,"props":236,"children":238},{"class":190,"line":237},6,[239],{"type":18,"tag":188,"props":240,"children":241},{"emptyLinePlaceholder":213},[242],{"type":28,"value":216},{"type":18,"tag":188,"props":244,"children":246},{"class":190,"line":245},7,[247],{"type":18,"tag":188,"props":248,"children":249},{},[250],{"type":28,"value":251},"# 2. 添加参数规则\n",{"type":18,"tag":188,"props":253,"children":255},{"class":190,"line":254},8,[256],{"type":18,"tag":188,"props":257,"children":258},{},[259],{"type":28,"value":260},"# 添加必选参数 -n（整数类型）\n",{"type":18,"tag":188,"props":262,"children":264},{"class":190,"line":263},9,[265],{"type":18,"tag":188,"props":266,"children":267},{},[268],{"type":28,"value":269},"parser.add_argument('-n', '--number', type=int, required=True, help='必选数字参数（整数），例如年龄')\n",{"type":18,"tag":188,"props":271,"children":273},{"class":190,"line":272},10,[274],{"type":18,"tag":188,"props":275,"children":276},{"emptyLinePlaceholder":213},[277],{"type":28,"value":216},{"type":18,"tag":188,"props":279,"children":281},{"class":190,"line":280},11,[282],{"type":18,"tag":188,"props":283,"children":284},{},[285],{"type":28,"value":286},"# 添加可选参数 -m（字符串类型，默认值为\"hello\"）\n",{"type":18,"tag":188,"props":288,"children":290},{"class":190,"line":289},12,[291],{"type":18,"tag":188,"props":292,"children":293},{},[294],{"type":28,"value":295},"parser.add_argument('-m', '--message', type=str, default='hello', help='可选字符串参数（默认值：hello）')\n",{"type":18,"tag":188,"props":297,"children":299},{"class":190,"line":298},13,[300],{"type":18,"tag":188,"props":301,"children":302},{"emptyLinePlaceholder":213},[303],{"type":28,"value":216},{"type":18,"tag":188,"props":305,"children":307},{"class":190,"line":306},14,[308],{"type":18,"tag":188,"props":309,"children":310},{},[311],{"type":28,"value":312},"# 添加标志参数 -v（无需值，出现则为True）\n",{"type":18,"tag":188,"props":314,"children":316},{"class":190,"line":315},15,[317],{"type":18,"tag":188,"props":318,"children":319},{},[320],{"type":28,"value":321},"parser.add_argument('-v', '--verbose', action='store_true', help='开启详细输出模式')\n",{"type":18,"tag":188,"props":323,"children":325},{"class":190,"line":324},16,[326],{"type":18,"tag":188,"props":327,"children":328},{"emptyLinePlaceholder":213},[329],{"type":28,"value":216},{"type":18,"tag":188,"props":331,"children":333},{"class":190,"line":332},17,[334],{"type":18,"tag":188,"props":335,"children":336},{},[337],{"type":28,"value":338},"# 3. 解析命令行参数\n",{"type":18,"tag":188,"props":340,"children":342},{"class":190,"line":341},18,[343],{"type":18,"tag":188,"props":344,"children":345},{},[346],{"type":28,"value":347},"args = parser.parse_args()\n",{"type":18,"tag":188,"props":349,"children":351},{"class":190,"line":350},19,[352],{"type":18,"tag":188,"props":353,"children":354},{"emptyLinePlaceholder":213},[355],{"type":28,"value":216},{"type":18,"tag":188,"props":357,"children":359},{"class":190,"line":358},20,[360],{"type":18,"tag":188,"props":361,"children":362},{},[363],{"type":28,"value":364},"# 4. 使用解析后的参数\n",{"type":18,"tag":188,"props":366,"children":368},{"class":190,"line":367},21,[369],{"type":18,"tag":188,"props":370,"children":371},{},[372],{"type":28,"value":373},"print(f\"数字参数: {args.number}（类型：{type(args.number)}）\")\n",{"type":18,"tag":188,"props":375,"children":377},{"class":190,"line":376},22,[378],{"type":18,"tag":188,"props":379,"children":380},{},[381],{"type":28,"value":382},"print(f\"消息参数: {args.message}（类型：{type(args.message)}）\")\n",{"type":18,"tag":188,"props":384,"children":386},{"class":190,"line":385},23,[387],{"type":18,"tag":188,"props":388,"children":389},{"emptyLinePlaceholder":213},[390],{"type":28,"value":216},{"type":18,"tag":188,"props":392,"children":394},{"class":190,"line":393},24,[395],{"type":18,"tag":188,"props":396,"children":397},{},[398],{"type":28,"value":399},"if args.verbose:\n",{"type":18,"tag":188,"props":401,"children":403},{"class":190,"line":402},25,[404],{"type":18,"tag":188,"props":405,"children":406},{},[407],{"type":28,"value":408},"    print(\"详细模式已开启：正在执行额外的日志输出...\")\n",{"type":18,"tag":40,"props":410,"children":412},{"id":411},"运行与测试",[413],{"type":28,"value":411},{"type":18,"tag":19,"props":415,"children":416},{},[417],{"type":28,"value":418},"在终端中运行脚本，传递不同参数测试效果：",{"type":18,"tag":172,"props":420,"children":422},{"id":421},"_1-基本用法传递必选参数-n",[423,425,430],{"type":28,"value":424},"1. 基本用法（传递必选参数 ",{"type":18,"tag":23,"props":426,"children":428},{"className":427},[],[429],{"type":28,"value":142},{"type":28,"value":76},{"type":18,"tag":178,"props":432,"children":436},{"className":433,"code":434,"language":435,"meta":7,"style":7},"language-bash shiki shiki-themes github-dark","python demo.py -n 25\n","bash",[437],{"type":18,"tag":23,"props":438,"children":439},{"__ignoreMap":7},[440],{"type":18,"tag":188,"props":441,"children":442},{"class":190,"line":191},[443,448,454,460],{"type":18,"tag":188,"props":444,"children":446},{"style":445},"--shiki-default:#B392F0",[447],{"type":28,"value":182},{"type":18,"tag":188,"props":449,"children":451},{"style":450},"--shiki-default:#9ECBFF",[452],{"type":28,"value":453}," demo.py",{"type":18,"tag":188,"props":455,"children":457},{"style":456},"--shiki-default:#79B8FF",[458],{"type":28,"value":459}," -n",{"type":18,"tag":188,"props":461,"children":462},{"style":456},[463],{"type":28,"value":464}," 25\n",{"type":18,"tag":19,"props":466,"children":467},{},[468],{"type":28,"value":469},"输出：",{"type":18,"tag":178,"props":471,"children":475},{"className":472,"code":473,"language":474,"meta":7,"style":7},"language-plaintext shiki shiki-themes github-dark","数字参数: 25（类型：\u003Cclass 'int'>）\n消息参数: hello（类型：\u003Cclass 'str'>）\n","plaintext",[476],{"type":18,"tag":23,"props":477,"children":478},{"__ignoreMap":7},[479,487],{"type":18,"tag":188,"props":480,"children":481},{"class":190,"line":191},[482],{"type":18,"tag":188,"props":483,"children":484},{},[485],{"type":28,"value":486},"数字参数: 25（类型：\u003Cclass 'int'>）\n",{"type":18,"tag":188,"props":488,"children":489},{"class":190,"line":200},[490],{"type":18,"tag":188,"props":491,"children":492},{},[493],{"type":28,"value":494},"消息参数: hello（类型：\u003Cclass 'str'>）\n",{"type":18,"tag":172,"props":496,"children":498},{"id":497},"_2-传递全部参数",[499],{"type":28,"value":500},"2. 传递全部参数",{"type":18,"tag":178,"props":502,"children":504},{"className":433,"code":503,"language":435,"meta":7,"style":7},"python demo.py -n 30 -m \"argparse真好用\" -v\n",[505],{"type":18,"tag":23,"props":506,"children":507},{"__ignoreMap":7},[508],{"type":18,"tag":188,"props":509,"children":510},{"class":190,"line":191},[511,515,519,523,528,533,538],{"type":18,"tag":188,"props":512,"children":513},{"style":445},[514],{"type":28,"value":182},{"type":18,"tag":188,"props":516,"children":517},{"style":450},[518],{"type":28,"value":453},{"type":18,"tag":188,"props":520,"children":521},{"style":456},[522],{"type":28,"value":459},{"type":18,"tag":188,"props":524,"children":525},{"style":456},[526],{"type":28,"value":527}," 30",{"type":18,"tag":188,"props":529,"children":530},{"style":456},[531],{"type":28,"value":532}," -m",{"type":18,"tag":188,"props":534,"children":535},{"style":450},[536],{"type":28,"value":537}," \"argparse真好用\"",{"type":18,"tag":188,"props":539,"children":540},{"style":456},[541],{"type":28,"value":542}," -v\n",{"type":18,"tag":19,"props":544,"children":545},{},[546],{"type":28,"value":469},{"type":18,"tag":178,"props":548,"children":550},{"className":472,"code":549,"language":474,"meta":7,"style":7},"数字参数: 30（类型：\u003Cclass 'int'>）\n消息参数: argparse真好用（类型：\u003Cclass 'str'>）\n详细模式已开启：正在执行额外的日志输出...\n",[551],{"type":18,"tag":23,"props":552,"children":553},{"__ignoreMap":7},[554,562,570],{"type":18,"tag":188,"props":555,"children":556},{"class":190,"line":191},[557],{"type":18,"tag":188,"props":558,"children":559},{},[560],{"type":28,"value":561},"数字参数: 30（类型：\u003Cclass 'int'>）\n",{"type":18,"tag":188,"props":563,"children":564},{"class":190,"line":200},[565],{"type":18,"tag":188,"props":566,"children":567},{},[568],{"type":28,"value":569},"消息参数: argparse真好用（类型：\u003Cclass 'str'>）\n",{"type":18,"tag":188,"props":571,"children":572},{"class":190,"line":209},[573],{"type":18,"tag":188,"props":574,"children":575},{},[576],{"type":28,"value":577},"详细模式已开启：正在执行额外的日志输出...\n",{"type":18,"tag":172,"props":579,"children":581},{"id":580},"_3-查看自动生成的帮助信息",[582],{"type":28,"value":583},"3. 查看自动生成的帮助信息",{"type":18,"tag":178,"props":585,"children":587},{"className":433,"code":586,"language":435,"meta":7,"style":7},"python demo.py -h  # 或 --help\n",[588],{"type":18,"tag":23,"props":589,"children":590},{"__ignoreMap":7},[591],{"type":18,"tag":188,"props":592,"children":593},{"class":190,"line":191},[594,598,602,607],{"type":18,"tag":188,"props":595,"children":596},{"style":445},[597],{"type":28,"value":182},{"type":18,"tag":188,"props":599,"children":600},{"style":450},[601],{"type":28,"value":453},{"type":18,"tag":188,"props":603,"children":604},{"style":456},[605],{"type":28,"value":606}," -h",{"type":18,"tag":188,"props":608,"children":610},{"style":609},"--shiki-default:#6A737D",[611],{"type":28,"value":612},"  # 或 --help\n",{"type":18,"tag":19,"props":614,"children":615},{},[616],{"type":28,"value":469},{"type":18,"tag":178,"props":618,"children":620},{"className":472,"code":619,"language":474,"meta":7,"style":7},"usage: demo.py [-h] -n NUMBER [-m MESSAGE] [-v]\n\n这是一个argparse示例脚本，用于演示参数解析\n\noptions:\n  -h, --help            show this help message and exit\n  -n NUMBER, --number NUMBER\n                        必选数字参数（整数），例如年龄\n  -m MESSAGE, --message MESSAGE\n                        可选字符串参数（默认值：hello）\n  -v, --verbose         开启详细输出模式\n",[621],{"type":18,"tag":23,"props":622,"children":623},{"__ignoreMap":7},[624,632,639,647,654,662,670,678,686,694,702],{"type":18,"tag":188,"props":625,"children":626},{"class":190,"line":191},[627],{"type":18,"tag":188,"props":628,"children":629},{},[630],{"type":28,"value":631},"usage: demo.py [-h] -n NUMBER [-m MESSAGE] [-v]\n",{"type":18,"tag":188,"props":633,"children":634},{"class":190,"line":200},[635],{"type":18,"tag":188,"props":636,"children":637},{"emptyLinePlaceholder":213},[638],{"type":28,"value":216},{"type":18,"tag":188,"props":640,"children":641},{"class":190,"line":209},[642],{"type":18,"tag":188,"props":643,"children":644},{},[645],{"type":28,"value":646},"这是一个argparse示例脚本，用于演示参数解析\n",{"type":18,"tag":188,"props":648,"children":649},{"class":190,"line":219},[650],{"type":18,"tag":188,"props":651,"children":652},{"emptyLinePlaceholder":213},[653],{"type":28,"value":216},{"type":18,"tag":188,"props":655,"children":656},{"class":190,"line":228},[657],{"type":18,"tag":188,"props":658,"children":659},{},[660],{"type":28,"value":661},"options:\n",{"type":18,"tag":188,"props":663,"children":664},{"class":190,"line":237},[665],{"type":18,"tag":188,"props":666,"children":667},{},[668],{"type":28,"value":669},"  -h, --help            show this help message and exit\n",{"type":18,"tag":188,"props":671,"children":672},{"class":190,"line":245},[673],{"type":18,"tag":188,"props":674,"children":675},{},[676],{"type":28,"value":677},"  -n NUMBER, --number NUMBER\n",{"type":18,"tag":188,"props":679,"children":680},{"class":190,"line":254},[681],{"type":18,"tag":188,"props":682,"children":683},{},[684],{"type":28,"value":685},"                        必选数字参数（整数），例如年龄\n",{"type":18,"tag":188,"props":687,"children":688},{"class":190,"line":263},[689],{"type":18,"tag":188,"props":690,"children":691},{},[692],{"type":28,"value":693},"  -m MESSAGE, --message MESSAGE\n",{"type":18,"tag":188,"props":695,"children":696},{"class":190,"line":272},[697],{"type":18,"tag":188,"props":698,"children":699},{},[700],{"type":28,"value":701},"                        可选字符串参数（默认值：hello）\n",{"type":18,"tag":188,"props":703,"children":704},{"class":190,"line":280},[705],{"type":18,"tag":188,"props":706,"children":707},{},[708],{"type":28,"value":709},"  -v, --verbose         开启详细输出模式\n",{"type":18,"tag":172,"props":711,"children":713},{"id":712},"_4-错误情况缺少必选参数",[714],{"type":28,"value":715},"4. 错误情况（缺少必选参数）",{"type":18,"tag":178,"props":717,"children":719},{"className":433,"code":718,"language":435,"meta":7,"style":7},"python demo.py -m \"测试\"\n",[720],{"type":18,"tag":23,"props":721,"children":722},{"__ignoreMap":7},[723],{"type":18,"tag":188,"props":724,"children":725},{"class":190,"line":191},[726,730,734,738],{"type":18,"tag":188,"props":727,"children":728},{"style":445},[729],{"type":28,"value":182},{"type":18,"tag":188,"props":731,"children":732},{"style":450},[733],{"type":28,"value":453},{"type":18,"tag":188,"props":735,"children":736},{"style":456},[737],{"type":28,"value":532},{"type":18,"tag":188,"props":739,"children":740},{"style":450},[741],{"type":28,"value":742}," \"测试\"\n",{"type":18,"tag":19,"props":744,"children":745},{},[746],{"type":28,"value":747},"输出（自动提示错误）：",{"type":18,"tag":178,"props":749,"children":751},{"className":472,"code":750,"language":474,"meta":7,"style":7},"error: the following arguments are required: -n\u002F--number\n",[752],{"type":18,"tag":23,"props":753,"children":754},{"__ignoreMap":7},[755],{"type":18,"tag":188,"props":756,"children":757},{"class":190,"line":191},[758],{"type":18,"tag":188,"props":759,"children":760},{},[761],{"type":28,"value":750},{"type":18,"tag":40,"props":763,"children":765},{"id":764},"核心参数说明add_argument-方法",[766,768,773],{"type":28,"value":767},"核心参数说明（",{"type":18,"tag":23,"props":769,"children":771},{"className":770},[],[772],{"type":28,"value":91},{"type":28,"value":93},{"type":18,"tag":775,"props":776,"children":777},"table",{},[778,797],{"type":18,"tag":779,"props":780,"children":781},"thead",{},[782],{"type":18,"tag":783,"props":784,"children":785},"tr",{},[786,792],{"type":18,"tag":787,"props":788,"children":789},"th",{},[790],{"type":28,"value":791},"参数",{"type":18,"tag":787,"props":793,"children":794},{},[795],{"type":28,"value":796},"作用说明",{"type":18,"tag":798,"props":799,"children":800},"tbody",{},[801,834,874,913,938,963,995],{"type":18,"tag":783,"props":802,"children":803},{},[804,814],{"type":18,"tag":805,"props":806,"children":807},"td",{},[808],{"type":18,"tag":23,"props":809,"children":811},{"className":810},[],[812],{"type":28,"value":813},"name",{"type":18,"tag":805,"props":815,"children":816},{},[817,819,824,826,832],{"type":28,"value":818},"参数名，如 ",{"type":18,"tag":23,"props":820,"children":822},{"className":821},[],[823],{"type":28,"value":142},{"type":28,"value":825}," 或 ",{"type":18,"tag":23,"props":827,"children":829},{"className":828},[],[830],{"type":28,"value":831},"--number",{"type":28,"value":833},"（短选项 \u002F 长选项，推荐同时提供）",{"type":18,"tag":783,"props":835,"children":836},{},[837,846],{"type":18,"tag":805,"props":838,"children":839},{},[840],{"type":18,"tag":23,"props":841,"children":843},{"className":842},[],[844],{"type":28,"value":845},"type",{"type":18,"tag":805,"props":847,"children":848},{},[849,851,857,859,865,866,872],{"type":28,"value":850},"参数类型（如 ",{"type":18,"tag":23,"props":852,"children":854},{"className":853},[],[855],{"type":28,"value":856},"int",{"type":28,"value":858},"、",{"type":18,"tag":23,"props":860,"children":862},{"className":861},[],[863],{"type":28,"value":864},"str",{"type":28,"value":858},{"type":18,"tag":23,"props":867,"children":869},{"className":868},[],[870],{"type":28,"value":871},"float",{"type":28,"value":873},"），自动转换输入值",{"type":18,"tag":783,"props":875,"children":876},{},[877,886],{"type":18,"tag":805,"props":878,"children":879},{},[880],{"type":18,"tag":23,"props":881,"children":883},{"className":882},[],[884],{"type":28,"value":885},"required",{"type":18,"tag":805,"props":887,"children":888},{},[889,891,897,899,905,907,912],{"type":28,"value":890},"是否必选（",{"type":18,"tag":23,"props":892,"children":894},{"className":893},[],[895],{"type":28,"value":896},"True",{"type":28,"value":898},"\u002F",{"type":18,"tag":23,"props":900,"children":902},{"className":901},[],[903],{"type":28,"value":904},"False",{"type":28,"value":906},"，默认 ",{"type":18,"tag":23,"props":908,"children":910},{"className":909},[],[911],{"type":28,"value":904},{"type":28,"value":76},{"type":18,"tag":783,"props":914,"children":915},{},[916,925],{"type":18,"tag":805,"props":917,"children":918},{},[919],{"type":18,"tag":23,"props":920,"children":922},{"className":921},[],[923],{"type":28,"value":924},"default",{"type":18,"tag":805,"props":926,"children":927},{},[928,930,936],{"type":28,"value":929},"可选参数的默认值（",{"type":18,"tag":23,"props":931,"children":933},{"className":932},[],[934],{"type":28,"value":935},"required=False",{"type":28,"value":937}," 时有效）",{"type":18,"tag":783,"props":939,"children":940},{},[941,950],{"type":18,"tag":805,"props":942,"children":943},{},[944],{"type":18,"tag":23,"props":945,"children":947},{"className":946},[],[948],{"type":28,"value":949},"help",{"type":18,"tag":805,"props":951,"children":952},{},[953,955,961],{"type":28,"value":954},"参数描述（",{"type":18,"tag":23,"props":956,"children":958},{"className":957},[],[959],{"type":28,"value":960},"-h",{"type":28,"value":962}," 时显示）",{"type":18,"tag":783,"props":964,"children":965},{},[966,975],{"type":18,"tag":805,"props":967,"children":968},{},[969],{"type":18,"tag":23,"props":970,"children":972},{"className":971},[],[973],{"type":28,"value":974},"action",{"type":18,"tag":805,"props":976,"children":977},{},[978,980,986,988,993],{"type":28,"value":979},"特殊动作，如 ",{"type":18,"tag":23,"props":981,"children":983},{"className":982},[],[984],{"type":28,"value":985},"store_true",{"type":28,"value":987}," 表示参数出现时赋值为 ",{"type":18,"tag":23,"props":989,"children":991},{"className":990},[],[992],{"type":28,"value":896},{"type":28,"value":994},"（用于标志参数）",{"type":18,"tag":783,"props":996,"children":997},{},[998,1007],{"type":18,"tag":805,"props":999,"children":1000},{},[1001],{"type":18,"tag":23,"props":1002,"children":1004},{"className":1003},[],[1005],{"type":28,"value":1006},"choices",{"type":18,"tag":805,"props":1008,"children":1009},{},[1010,1012,1018],{"type":28,"value":1011},"限制参数可选值（如 ",{"type":18,"tag":23,"props":1013,"children":1015},{"className":1014},[],[1016],{"type":28,"value":1017},"choices=[1,2,3]",{"type":28,"value":76},{"type":18,"tag":40,"props":1020,"children":1022},{"id":1021},"总结",[1023],{"type":28,"value":1021},{"type":18,"tag":129,"props":1025,"children":1026},{},[1027,1043,1048],{"type":18,"tag":50,"props":1028,"children":1029},{},[1030,1035,1037],{"type":18,"tag":23,"props":1031,"children":1033},{"className":1032},[],[1034],{"type":28,"value":29},{"type":28,"value":1036}," 简化了命令行参数的解析逻辑，无需手动处理 ",{"type":18,"tag":23,"props":1038,"children":1040},{"className":1039},[],[1041],{"type":28,"value":1042},"sys.argv",{"type":18,"tag":50,"props":1044,"children":1045},{},[1046],{"type":28,"value":1047},"支持自动类型转换、参数校验和帮助信息生成",{"type":18,"tag":50,"props":1049,"children":1050},{},[1051],{"type":28,"value":1052},"适合开发命令行工具、脚本等需要动态配置的场景",{"type":18,"tag":1054,"props":1055,"children":1056},"style",{},[1057],{"type":28,"value":1058},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}",{"title":7,"searchDepth":200,"depth":200,"links":1060},[1061,1062,1063,1064,1066],{"id":42,"depth":209,"text":42},{"id":120,"depth":209,"text":120},{"id":411,"depth":209,"text":411},{"id":764,"depth":209,"text":1065},"核心参数说明（add_argument() 方法）",{"id":1021,"depth":209,"text":1021},"markdown","content:blog:2026-03-01-argparse-guide.md","content","blog\u002F2026-03-01-argparse-guide.md","blog\u002F2026-03-01-argparse-guide","md",1780801017645]