Python命令行读取参数|完整攻略与实战解析

一、入门基础:什么是命令行参数?为何要掌握它?

命令行参数是指在运行Python脚本时,通过终端输入的附加信息,用于动态控制脚本行为。例如:

python myscript.py --input data.csv --output result.json --verbose

上述命令中,--input、--output、--verbose即为命令行参数。掌握参数读取能力,是开发CLI(命令行界面)工具、自动化脚本、数据处理流水线的基石。

相较于GUI界面,CLI具有三大核心优势:

  • ⚡ 高效可组合:可无缝接入Shell管道(|)、重定向(>)、批处理脚本。
  • ⚙️ 轻量无依赖:无需图形环境,服务器、Docker容器中可直接运行。
  • 〔可编程〕:参数可编程化传递,支持动态配置与条件分支。

主流Python命令行参数解析方案有三种:原生sys.argv、标准库getopt、现代方案argparse。本文将逐层深入,辅以真实场景案例,助您构建健壮、可维护的CLI工具。

1.1 为何sys.argv是起点?

sys.argv是Python最基础的参数入口,它是一个字符串列表,其中:

示例:创建echo.py:

import sys
print("脚本名:", sys.argv[0])
print("参数列表:", sys.argv[1:])
print("参数个数:", len(sys.argv) - 1)

运行:

$ python echo.py hello world 123
脚本名: echo.py
参数列表: ['hello', 'world', '123']
参数个数: 3

但sys.argv存在明显局限:

因此,仅适用于极简脚本。复杂场景推荐使用argparse。

二、sys.argv深度解析:基础但不可忽视的入口

尽管sys.argv原始,但理解其机制对调试与底层开发至关重要。其核心特性如下:

  • 【固定结构】:列表,元素均为字符串类型。
  • 【无解析逻辑】:仅原样传递终端输入,不区分选项与值。
  • 【跨平台兼容】:Windows与Linux/macOS行为一致。

常见陷阱与解决方案:

2.1 空参数处理

若未传参数,sys.argv[1:]为空列表,需主动判断:

import sys
if len(sys.argv) < 2:
    print("⚠️ 错误:未提供输入文件路径!")
    print("用法: python script.py <输入文件>")
    sys.exit(1)
input_file = sys.argv[1]
print(f"✅ 处理文件: {input_file}")

2.2 位置参数 vs 选项参数

在sys.argv中,参数类型需手动区分:

# 调用: python script.py data.csv --mode batch --output res.txt
# sys.argv = ['script.py', 'data.csv', '--mode', 'batch', '--output', 'res.txt']

需手动解析:data.csv为位置参数,--mode与batch为选项参数对,--output与res.txt为另一对。

典型解析逻辑(简易版):

import sys
args = sys.argv[1:]
files = []
options = {}
i = 0
while i < len(args):
    if args[i].startswith('--'):
        if i + 1 < len(args) and not args[i+1].startswith('--'):
            options[args[i]] = args[i+1]
            i += 2
        else:
            options[args[i]] = True
            i += 1
    else:
        files.append(args[i])
        i += 1
print("文件:", files)
print("选项:", options)

输出:

文件: ['data.csv']
选项: {'--mode': 'batch', '--output': 'res.txt'}

⚠️ 注意:此方案未处理缩写(如-h)、多值选项(如-f a.txt b.txt),且缺乏错误处理,仅作教学参考。

2.3 实战案例:简易文件处理工具

实现一个基础文件统计工具word_count.py:

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
import sys
def count_words(text):
    """统计文本中的单词数、行数、字符数"""
    lines = text.splitlines()
    words = text.split()
    chars = len(text)
    return len(lines), len(words), chars
if len(sys.argv) < 2:
    print("使用方式: python word_count.py <文件路径> [-l] [-w] [-c]")
    sys.exit(1)
file_path = sys.argv[1]
options = sys.argv[2:]
try:
    with open(file_path, 'r', encoding='utf-8') as f:
        content = f.read()
except FileNotFoundError:
    print(f"❌ 错误:文件 '{file_path}' 不存在!")
    sys.exit(1)
lines, words, chars = count_words(content)
show_all = not any(opt in options for opt in ['-l', '-w', '-c'])
if show_all or '-l' in options:
    print(f"行数: {lines}")
if show_all or '-w' in options:
    print(f"单词数: {words}")
if show_all or '-c' in options:
    print(f"字符数: {chars}")

运行示例:

$ python word_count.py report.txt -w -c
单词数: 1247
字符数: 8532

此脚本展示了sys.argv在资源受限场景(如嵌入式系统)中的实用价值,但其扩展性弱,维护成本高。

三、getopt模块:传统但可靠的轻量方案

getopt是Python标准库中模拟C语言getopt的模块,支持短选项(-h)与长选项(--help),适用于中等复杂度脚本。

核心函数:

  • getopt.getopt(args, shortopts, longopts=[]) → (opts, args)
  • args:待解析参数列表(通常为sys.argv[1:])
  • shortopts:短选项字符串(如"ho:"中o:表示-o需参数)
  • longopts:长选项列表(如["help", "output="])
  • opts:解析出的(选项, 值)元组列表
  • args:剩余位置参数列表

3.1 基础解析流程

import getopt
import sys
try:
    opts, args = getopt.getopt(sys.argv[1:], "hi:o:", ["help", "input=", "output="])
except getopt.GetoptError as e:
    print(f"❌ 选项错误: {e}")
    sys.exit(2)
print("选项:", opts)
print("位置参数:", args)

运行:

$ python script.py -i data.csv -o res.txt file1 file2
选项: [('-i', 'data.csv'), ('-o', 'res.txt')]
位置参数: ['file1', 'file2']

⚠️ 注意:短选项h未带:表示无参数,i:与o:带:表示需参数;长选项help无=表示无参数,input=与output=带=表示需参数。

3.2 实战案例:带帮助信息的配置工具

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
import getopt
import sys
def print_usage():
    print("""使用方式: config_tool.py [选项] <配置文件>
选项:
  -h, --help        显示帮助信息
  -i, --input=FILE  输入配置文件(必需)
  -o, --output=FILE 输出结果文件(可选)
  -v, --verbose     详细模式
示例:
  python config_tool.py -i app.conf -o output.json
  python config_tool.py --input=app.conf --output=output.json -v""")
def main():
    if len(sys.argv) == 1:
        print_usage()
        sys.exit(1)
    try:
        opts, args = getopt.getopt(sys.argv[1:], "hi:o:v", ["help", "input=", "output=", "verbose"])
    except getopt.GetoptError as e:
        print(f"❌ 错误: {e}")
        print("使用 -h 查看帮助")
        sys.exit(2)
    input_file = None
    output_file = None
    verbose = False
    for opt, arg in opts:
        if opt in ("-h", "--help"):
            print_usage()
            sys.exit(0)
        elif opt in ("-i", "--input"):
            input_file = arg
        elif opt in ("-o", "--output"):
            output_file = arg
        elif opt in ("-v", "--verbose"):
            verbose = True
    if not input_file:
        print("❌ 错误:缺少必需参数 -i/--input")
        sys.exit(3)
    if verbose:
        print(f"✅ 输入文件: {input_file}")
        print(f"📄 输出文件: {output_file or 'stdout'}")
    # 模拟处理
    print("⚙️ 配置处理完成!")
if __name__ == "__main__":
    main()

运行:

$ python config_tool.py -i config.yaml -v
✅ 输入文件: config.yaml
📄 输出文件: stdout
⚙️ 配置处理完成!

getopt优势在于轻量、无第三方依赖;劣势是错误处理需手动编写,不支持自动帮助生成与类型校验。

四、argparse模块:现代Python CLI开发的黄金标准

argparse是Python 3推荐的参数解析模块,功能远超getopt,支持:

  • ✅ 自动生成帮助文档(-h/--help)
  • ✅ 参数类型自动转换(int、float、自定义函数)
  • ✅ 必填参数与默认值支持
  • ✅ 子命令(如git commit、git push)
  • ✅ 互斥参数组、参数依赖校验
  • 【自定义错误消息】

核心对象:ArgumentParser,通过add_argument()添加参数定义。

4.1 基础用法:位置参数与选项参数

import argparse
parser = argparse.ArgumentParser(description="处理数据文件并生成报告")
parser.add_argument("input_file", help="输入数据文件路径")
parser.add_argument("-o", "--output", default="report.json", help="输出文件路径")
parser.add_argument("-v", "--verbose", action="store_true", help="启用详细模式")
args = parser.parse_args()
print(f"输入文件: {args.input_file}")
print(f"输出文件: {args.output}")
print(f"详细模式: {'是' if args.verbose else '否'}")

运行:

$ python data_proc.py data.csv -o result.txt -v
输入文件: data.csv
输出文件: result.txt
详细模式: 是
$ python data_proc.py -h
用法: data_proc.py [-h] [-o OUTPUT] [-v] input_file
处理数据文件并生成报告
位置参数:
  input_file            输入数据文件路径
选项:
  -h, --help            显示帮助信息
  -o OUTPUT, --output OUTPUT
                        输出文件路径 (默认: report.json)
  -v, --verbose         启用详细模式

4.2 高级特性:类型校验与自定义动作

import argparse
import os
def file_exists(path):
    if not os.path.isfile(path):
        raise argparse.ArgumentTypeError(f"❌ 文件不存在: {path}")
    return path
parser = argparse.ArgumentParser()
parser.add_argument("--config", type=file_exists, required=True, help="配置文件路径(必须存在)")
parser.add_argument("--threads", type=int, default=4, help="线程数(默认4)")
parser.add_argument("--level", choices=["DEBUG", "INFO", "WARNING", "ERROR"], default="INFO", help="日志级别")
args = parser.parse_args()
print(f"配置: {args.config}")
print(f"线程: {args.threads}")
print(f"级别: {args.level}")

运行:

$ python app.py --config missing.json
usage: app.py [-h] [--config CONFIG] [--threads THREADS] [--level LEVEL]
app.py: error: argument --config: ❌ 文件不存在: missing.json
$ python app.py --config valid.json --threads abc
usage: app.py [-h] [--config CONFIG] [--threads THREADS] [--level LEVEL]
app.py: error: argument --threads: invalid int value: 'abc'

通过type=file_exists与choices,实现强类型校验与输入约束。

4.3 子命令:构建多命令工具

实现类似git的多命令结构:

import argparse
def cmd_init(args):
    print(f"⚙️ 初始化项目: {args.project_name}")
    if args.template:
        print(f"📄 使用模板: {args.template}")
def cmd_build(args):
    print(f"🔨 构建项目: {args.project_name}")
    print(f"📦 环境: {args.env}")
    if args.verbose:
        print("📝 详细输出")
parser = argparse.ArgumentParser(prog="mycli")
subparsers = parser.add_subparsers(dest="command", required=True)
# init子命令
init_parser = subparsers.add_parser("init", help="初始化新项目")
init_parser.add_argument("project_name", help="项目名称")
init_parser.add_argument("-t", "--template", help="模板名称")
init_parser.set_defaults(func=cmd_init)
# build子命令
build_parser = subparsers.add_parser("build", help="构建项目")
build_parser.add_argument("project_name", help="项目名称")
build_parser.add_argument("-e", "--env", choices=["dev", "prod"], default="dev", help="环境")
build_parser.add_argument("-v", "--verbose", action="store_true", help="详细模式")
build_parser.set_defaults(func=cmd_build)
args = parser.parse_args()
args.func(args)

运行:

$ python mycli.py init myapp -t react
⚙️ 初始化项目: myapp
📄 使用模板: react
$ python mycli.py build myapp -e prod -v
🔨 构建项目: myapp
📦 环境: prod
📝 详细输出

子命令通过add_subparsers创建,每个子命令绑定独立参数与处理函数,是构建复杂CLI的首选方案。

4.4 实战案例:完整数据处理流水线

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
import argparse
import json
import sys
def parse_args():
    parser = argparse.ArgumentParser(
        description="📊 数据处理流水线:清洗、转换、导出",
        epilog="示例: python pipeline.py process -i data.csv -o result.json --clean"
    )
    subparsers = parser.add_subparsers(dest="mode", required=True)
    # process子命令
    p_parser = subparsers.add_parser("process", help="处理数据文件")
    p_parser.add_argument("-i", "--input", required=True, help="输入文件(CSV/JSON)")
    p_parser.add_argument("-o", "--output", required=True, help="输出文件路径")
    p_parser.add_argument("--clean", action="store_true", help="启用数据清洗")
    p_parser.add_argument("--verbose", action="store_true", help="详细模式")
    # validate子命令
    v_parser = subparsers.add_parser("validate", help="验证数据格式")
    v_parser.add_argument("-i", "--input", required=True, help="输入文件")
    v_parser.add_argument("--schema", help="JSON Schema文件路径")
    return parser.parse_args()
def load_data(path):
    if path.endswith(".csv"):
        import csv
        with open(path, newline='', encoding='utf-8') as f:
            return list(csv.DictReader(f))
    elif path.endswith(".json"):
        with open(path, 'r', encoding='utf-8') as f:
            return json.load(f)
    else:
        raise ValueError("仅支持.csv或.json格式")
def clean_data(data):
    # 模拟清洗:移除空值行
    return [row for row in data if any(row.values())]
def process_data(args):
    data = load_data(args.input)
    if args.clean:
        data = clean_data(data)
    if args.verbose:
        print(f"✅ 加载 {len(data)} 条记录")
        if args.clean:
            print("🧹 数据已清洗")
    with open(args.output, 'w', encoding='utf-8') as f:
        json.dump(data, f, indent=2, ensure_ascii=False)
    print(f"📄 结果已保存至: {args.output}")
def validate_data(args):
    data = load_data(args.input)
    print(f"✅ 数据结构校验通过:{len(data)} 条记录")
    if args.schema:
        print(f"🔍 使用Schema: {args.schema}")
        # 实际可接入jsonschema库校验
    print("✅ 格式验证完成")
def main():
    args = parse_args()
    if args.mode == "process":
        process_data(args)
    elif args.mode == "validate":
        validate_data(args)
    else:
        sys.exit(1)
if __name__ == "__main__":
    main()

此脚本整合argparse所有核心特性,是生产级CLI工具的模板。

五、CLI工具开发实战技巧与最佳实践

5.1 参数顺序与解析时机

在argparse中,选项与位置参数顺序可任意,但子命令必须在前。例如:

# 正确:子命令在前
python mycli.py init myapp
# 错误:子命令后置
python mycli.py myapp init  # 会报错:未知参数 'init'

优化建议:使用parse_intermixed_args()(Python 3.7+)允许混合顺序:

parser.parse_intermixed_args(sys.argv[1:])

5.2 错误处理与退出码规范

遵循Unix惯例的退出码:

退出码含义示例
0成功处理完成
1通用错误文件不存在
2命令行参数错误无效选项
126命令不可执行权限不足
127命令未找到Python未安装

推荐实现:

import sys
try:
    # 业务逻辑
    pass
except FileNotFoundError:
    print("❌ 错误:输入文件不存在", file=sys.stderr)
    sys.exit(1)
except ValueError as e:
    print(f"❌ 参数错误: {e}", file=sys.stderr)
    sys.exit(2)

5.3 用户体验增强技巧

  • 【进度提示】:使用sys.stderr.write("\r处理中: {:.1%}".format(i/total))动态更新进度
  • 【颜色输出】:通过colorama或ANSI码实现彩色提示(\033[32m✅\033[0m)
  • 【配置文件回退】:当参数缺失时,自动读取~/.config/app/config.json
  • 【交互式确认】:危险操作前提示是否继续?[y/N]

示例:进度条实现

import sys
import time
def progress(iterable, desc="处理中"):
    total = len(iterable)
    for i, item in enumerate(iterable, 1):
        sys.stderr.write(f"\r{desc}: {'█' * int(i/total*20):20s} {i/total:.0%}")
        yield item
    sys.stderr.write("\n")
for _ in progress(range(100), "转换中"):
    time.sleep(0.05)

5.4 调试与日志集成

将argparse与logging模块结合:

import logging
import argparse
parser = argparse.ArgumentParser()
parser.add_argument("--log-level", default="INFO", choices=["DEBUG","INFO","WARNING","ERROR"],
                   help="日志级别")
args = parser.parse_args()
logging.basicConfig(
    level=getattr(logging, args.log_level),
    format="%(asctime)s [%(levelname)s] %(message)s"
)
logging.debug("调试信息")
logging.info("处理启动")
logging.warning("资源不足警告")

运行:

$ python app.py --log-level DEBUG
2024-05-20 14:30:22 [DEBUG] 调试信息
2024-05-20 14:30:22 [INFO] 处理启动

六、网友最关心的10个问题深度解答

问题描述:使用choices=["dev", "prod"]时,传入dev却报错invalid choice: 'dev'。

根本原因:参数值前后存在不可见空格(如终端粘贴时的换行符)。

解决方案:

  1. 在add_argument中添加type=str.strip自动去空格:
  2. 或手动校验前使用arg.strip():
parser.add_argument("--env",
                    type=lambda x: x.strip(),
                    choices=["dev", "prod"],
                    default="dev")

验证:$ python app.py --env " dev " → 自动转为dev通过校验。

问题描述:参数值含空格(如-d "my data")时,被错误拆分为多个参数。

解决方案:

  • ✅ Shell中用引号包裹(双引号优先)
  • ✅ 使用nargs="+"接收多值(但需引号)
  • ✅ 转义空格(my\ data)

错误示例:

$ python app.py -d my data.txt  # 错误!data.txt被当作新参数

正确示例:

$ python app.py -d "my data.txt"  # 正确
$ python app.py -d my\ data.txt   # 正确

问题描述:希望参数缺失时自动从环境变量读取(如DB_URL)。

解决方案:自定义type函数:

import os
import argparse
def env_or_value(value):
    if value == "AUTO":
        return os.getenv("DB_URL", "sqlite:///default.db")
    return value
parser = argparse.ArgumentParser()
parser.add_argument("--db", type=env_or_value, default="AUTO")
args = parser.parse_args()
print(f"数据库: {args.db}")

运行:

$ export DB_URL="postgresql://user:pass@localhost/db"
$ python app.py --db AUTO
数据库: postgresql://user:pass@localhost/db

问题描述:需要支持-f file1.txt file2.txt file3.txt形式的多值参数。

解决方案:使用nargs="*"或nargs="+":

parser.add_argument("-f", "--files", nargs="+",
                    help="输入文件列表(至少1个)")
args = parser.parse_args(["-f", "a.txt", "b.txt", "c.txt"])
print(args.files)  # ['a.txt', 'b.txt', 'c.txt']

注意:

  • nargs="*":0或多个值(空列表有效)
  • nargs="+":1或多个值(必须至少1个)

问题描述:脚本执行中需暂停等待用户输入(如input("继续?"))。

解决方案:

  1. 【非交互式场景】:改用argparse参数控制流程(更可靠)
  2. 【必须交互】:检测sys.stdin.isatty()判断是否在终端运行
import sys
if sys.stdin.isatty():
    # 在终端运行,可交互
    confirm = input("是否继续?[y/N] ")
else:
    # 非交互(如管道),直接跳过或报错
    print("警告:非交互环境,跳过输入", file=sys.stderr)
    sys.exit(1)

问题描述:当参数A存在时,参数B必须存在(如--config存在时--mode必需)。

解决方案:解析后校验依赖:

parser.add_argument("--config", help="配置文件")
parser.add_argument("--mode", choices=["dev", "prod"], help="运行模式")
args = parser.parse_args()
if args.config and not args.mode:
    parser.error("--mode 是 --config 的必需参数")
print(args)

运行:

$ python app.py --config app.json
usage: app.py [-h] [--config CONFIG] [--mode MODE]
app.py: error: --mode 是 --config 的必需参数

问题描述:用户输入--ver时自动识别为--version。

解决方案:使用argparse.REMAINDER或自定义ArgumentParser子类:

class PartialMatchParser(argparse.ArgumentParser):
    def _get_option_tuples(self, option_string):
        option_tuples = super()._get_option_tuples(option_string)
        if not option_tuples:
            # 尝试匹配前缀
            for action in self._actions:
                for opt in action.option_strings:
                    if opt.startswith(option_string):
                        option_tuples.append((action, opt))
        return option_tuples
parser = PartialMatchParser()
parser.add_argument("--verbose", action="store_true")
parser.add_argument("--version", action="store_true")
args = parser.parse_args(["--ver"])
print(args.verbose)  # True

⚠️ 注意:标准argparse不支持缩写,此方案需谨慎使用以避免歧义。

问题描述:参数含shell特殊字符(如*.txt被shell扩展为文件列表)。

解决方案:

  • 【用户端】:用单引号包裹('*.txt')避免shell解析
  • 【脚本端】:在Python中处理时检查原始字符串
import sys
# 用户输入: python app.py '*.txt'
print(sys.argv[1])  # '*.txt'(未被扩展)

问题描述:默认帮助文档格式不符合项目风格。

解决方案:自定义Formatter类:

class CustomHelpFormatter(argparse.RawDescriptionHelpFormatter):
    def format_help(self):
        help_text = super().format_help()
        return "╔════════════════════════════════════════════════════════╗\n" + \
               "║  📊 数据处理工具 v1.0                                  ║\n" + \
               "╠════════════════════════════════════════════════════════╣\n" + \
               help_text.replace("options:", "⚙️  选项").replace("positional arguments:", "📁 位置参数") + \
               "╚════════════════════════════════════════════════════════╝"
parser = argparse.ArgumentParser(formatter_class=CustomHelpFormatter)

问题描述:在Bash/Zsh中按Tab键自动补全子命令与参数。

解决方案:生成shell补全脚本(以Bash为例):

  1. 安装argcomplete:pip install argcomplete
  2. 在脚本中添加:
    import argcomplete
    argcomplete.autocomplete(parser)
  3. 注册补全脚本:
    eval "$(register-python-argcomplete mycli)"

之后可直接输入mycli [TAB]显示所有子命令。

七、周边工具与生态:提升CLI开发效率

7.1 命令行辅助库对比

工具类型优势适用场景
click第三方装饰器风格、自动子命令、颜色支持中大型项目(如Flask CLI)
typer第三方类型提示驱动、异步支持、自动文档现代Python项目(需Python 3.6+)
docopt第三方通过文档字符串定义参数极简脚本(文档即接口)
fire第三方自动将任何对象转为CLI快速原型、内部工具

7.2 click vs argparse:关键差异

以参数定义为例:

# argparse
parser.add_argument("--name", required=True, help="姓名")
# click
@click.option("--name", required=True, help="姓名")

click优势:

  • 【装饰器链式调用】:@click.option + @click.argument
  • 【自动密码输入】:password=True隐藏输入
  • 【环境变量绑定】:envvar="USER_NAME"
  • 【进度条支持】:click.progressbar

click示例:

import click
@click.command()
@click.option("--name", prompt="您的姓名", help="用户姓名")
@click.option("--password", prompt=True, hide_input=True, help="密码")
def hello(name, password):
    click.echo(f"您好, {name}!")
if __name__ == "__main__":
    hello()

运行时自动提示输入,且密码隐藏显示。

7.3 typer:类型提示驱动的CLI

typer基于typing`模块,自动生成类型校验与帮助文档:

import typer
def main(name: str, age: int = 18, verbose: bool = False):
    """问候用户"""
    if verbose:
        print(f"年龄: {age}")
    print(f"您好, {name}!")
if __name__ == "__main__":
    typer.run(main)

优势:

  • 【类型自动校验】:age必须为整数
  • 【默认值提示】:age=18显示在帮助中
  • 【文档即代码】:函数注释自动生成帮助文本

输出帮助:

$ python app.py --help
用法: app.py [OPTIONS] NAME
问候用户
位置参数:
  NAME  [required]
选项:
  --age INTEGER  [default: 18]
  --verbose / --no-verbose  [default: False]
  --help                      显示帮助信息

7.4 真实项目推荐组合

企业级CLI工具开发建议栈:

  1. 【argparse】:核心参数解析(稳定、标准)
  2. 【rich】:美化输出(表格、进度条、高亮)
  3. 【loguru】:结构化日志
  4. 【pydantic】:配置验证
  5. 【click-completion】:Bash/Zsh自动补全

示例:使用rich美化输出

from rich.console import Console
from rich.table import Table
console = Console()
table = Table(title="📊 处理结果")
table.add_column("指标", style="cyan")
table.add_column("数值", justify="right", style="magenta")
table.add_row("处理记录", "1,247")
table.add_row("耗时", "3.2s")
console.print(table)

九、总结与学习路径

本文系统梳理了python命令行读取参数的完整技术栈:

  • 【基础层】sys.argv:理解参数传递机制
  • 【标准层】getopt:轻量级解析方案
  • 【核心层】argparse:现代CLI开发基石
  • 【生态层】click、typer等:提升开发效率

学习建议路径:

  1. 【入门】:用sys.argv实现简单脚本(理解参数本质)
  2. 【进阶】:用argparse构建完整CLI(掌握子命令、类型校验)
  3. 【优化】:集成rich、loguru增强体验
  4. 【专业】:研究click、typer源码,定制高级功能

最终目标:写出可测试、可复用、可维护的命令行工具,成为自动化脚本与DevOps流程的可靠基石。

附:关键代码速查表

# 基础解析
parser = argparse.ArgumentParser()
parser.add_argument("-i", "--input", required=True)
parser.add_argument("-o", "--output", default="out.json")
args = parser.parse_args()
# 子命令
subparsers = parser.add_subparsers(dest="cmd", required=True)
sub = subparsers.add_parser("run")
sub.add_argument("--verbose", action="store_true")
# 环境变量回退
def env_val(v):
    return os.getenv(v.upper(), v)
parser.add_argument("--db", type=env_val, default="sqlite:///:memory:")
# 交互式输入
if sys.stdin.isatty():
    confirm = input("继续?[y/N] ")
else:
    print("非交互环境,跳过", file=sys.stderr)