想把脚本变成命令行工具？用argparse+装饰器10分钟搞定
你是否写过很多实用的Python脚本，但每次修改参数都要打开代码改路径、改阈值？或者想分享给同事使用，却因为硬编码参数而让人望而却步？今天，我将带你用argparse + 装饰器的组合，在10分钟内让你的普通脚本脱胎换骨，成为优雅的命令行工具（CLI）。无需任何外部库，纯Python标准库就能实现专业级参数解析、子命令管理、自动帮助生成。读完本文，你不仅掌握argparse核心技巧，还会学会用装饰器消除重复代码，让函数一键变成CLI指令。
💡 先导效果： 原本你只能通过修改代码内部变量运行
python process.py，改造后可以直接执行python cli.py --input data.csv --output result.csv --verbose，甚至支持python cli.py convert --format json子命令，专业感拉满。
一、为什么要把脚本变成命令行工具？
在日常开发、数据分析、自动化运维中，脚本通常需要灵活配置。硬编码参数导致复用性差，每次更改都要重新运行编辑器。命令行工具遵循Unix哲学，支持参数化输入、管道组合、脚本化调用，能够无缝嵌入Shell脚本、CI/CD流水线，并且他人使用时只需查看 --help 即可上手。据统计，超过70%的Python开发者曾尝试将脚本CLI化，而argparse作为标准库首选，稳定可靠。但是写出整洁且可扩展的CLI往往需要不少样板代码，而装饰器模式恰好可以大幅简化。
二、argparse基础：五分钟掌握核心API
argparse是Python内置的命令行参数解析模块，我们首先回顾一下标准用法：创建解析器，添加参数，解析命名空间。一个简单的例子：
import argparse parser = argparse.ArgumentParser(description='示例：文件处理') parser.add_argument('--input', '-i', required=True, help='输入文件路径') parser.add_argument('--output', '-o', default='out.txt', help='输出文件') parser.add_argument('--verbose', '-v', action='store_true', help='详细输出') args = parser.parse_args() if args.verbose: print(f"处理 {args.input} -> {args.output}")执行 python demo.py --input data.csv --verbose 就能拿到参数对象。这种写法很直观，但当脚本函数增多、逻辑复杂时，每个函数都需要重复写参数定义和解析逻辑，代码冗长且维护困难。这时候「装饰器」登场，将参数声明与函数绑定，自动化生成CLI入口。
三、装饰器快速入门：为函数增加「命令行铠甲」
装饰器本质上是一个高阶函数，接收函数作为参数并返回一个新函数。它可以在不修改原函数代码的情况下扩展功能。结合argparse，我们可以设计一个 @cli_command 装饰器，将函数参数名自动映射为命令行参数，并负责解析和注入。这种模式类似于轻量级框架 (如Click) 的内部原理，但完全可控且无依赖。下面一步步实现。
3.1 设计目标：零样板调用
我们希望达到以下效果：
@command def greet(name: str, repeat: int = 1, shout: bool = False): for _ in range(repeat): msg = f"Hello {name}" if shout: msg = msg.upper() print(msg) if __name__ == "__main__": run() # 自动解析sys.argv并调用greet终端运行 python script.py --name Alice --repeat 3 --shout 即可。这样的魔力背后就是装饰器+argparse。
四、手写一个强大的 CLI 装饰器（核心干货）
我们将构建一个简易的 CommandRegistry 类，负责注册函数、生成解析器、处理参数类型转换。为了支持多命令（子命令），我们稍后扩展，但先从单命令开始，再演进到多命令模式。
4.1 基础版本：单命令自动解析
import argparse import inspect import sys from functools import wraps class CliApp: def __init__(self): self.commands = {} # 名称 -> 函数 self.default_func = None def command(self, func=None, *, name=None): """装饰器：注册命令行函数""" def decorator(f): cmd_name = name or f.__name__ self.commands[cmd_name] = f @wraps(f) def wrapper(*args, **kwargs): return f(*args, **kwargs) return wrapper if func is None: return decorator return decorator(func) def run(self): """自动解析参数并执行对应函数""" if not self.comm