Python命令行工具开发：从基础到进阶实践

1. Python命令行应用开发基础

命令行应用（CLI）是开发者日常工作中不可或缺的工具类型。Python作为一门脚本语言，在CLI开发领域有着天然优势。我使用Python开发命令行工具已有8年经验，从简单的自动化脚本到复杂的多命令工具都实践过。

Python标准库和丰富的第三方库为CLI开发提供了完整支持。根据项目复杂度不同，我们可以选择不同层级的解决方案。对于刚接触CLI开发的新手，建议从标准库argparse开始学习，这是理解命令行参数解析的最佳途径。

注意：在开发生产环境使用的CLI工具时，建议始终使用argparse或更高级的库，避免直接处理sys.argv，这能显著提高代码的健壮性和可维护性。

1.1 为什么选择Python开发CLI

Python在CLI开发中具有几个独特优势：

1. 跨平台支持：Python解释器在Windows、Linux和macOS上都能运行
2. 丰富的标准库：内置了argparse、getopt等命令行解析工具
3. 第三方生态：click、typer等专业库提供了更高级功能
4. 快速开发：Python的简洁语法特别适合快速实现原型

我在实际项目中发现，用Python开发的CLI工具通常代码量只有C/C++的1/3，开发效率却能提高2-3倍。特别是需要处理文本、文件或网络请求的场景，Python的内置支持让开发变得异常简单。

2. 基础方案：使用sys.argv

2.1 sys.argv的基本用法

sys.argv是最基础的命令行参数获取方式，适合非常简单的脚本。它本质上是一个包含命令行参数的列表，其中：

• sys.argv[0]是脚本名称
• sys.argv[1]是第一个参数
• 以此类推

python复制import sys

def main():
    if len(sys.argv) < 2:
        print("Usage: python script.py <name> [--age <age>]")
        sys.exit(1)
    
    name = sys.argv[1]
    age = None
    if len(sys.argv) > 3 and sys.argv[2] == '--age':
        age = sys.argv[3]
    
    print(f"Hello, {name}!")
    if age:
        print(f"You are {age} years old.")

if __name__ == "__main__":
    main()

2.2 sys.argv的优缺点分析

优点：

• 无需任何额外依赖
• 适合极简的临时脚本
• 学习成本几乎为零

缺点：

• 参数解析逻辑需要手动实现
• 不支持自动生成帮助信息
• 缺乏类型检查和参数验证
• 代码难以维护和扩展

在实际项目中，我发现sys.argv最大的问题是错误处理。当用户输入不符合预期时，脚本很容易崩溃或产生误导性输出。我曾经维护过一个使用sys.argv的生产脚本，后来花了大量时间重写为argparse版本，因为原始实现无法处理各种边界情况。

3. 标准库方案：使用argparse

3.1 argparse核心功能解析

argparse是Python标准库中最强大的命令行解析工具，提供了：

• 自动生成帮助和使用说明
• 参数类型检查和转换
• 子命令支持
• 参数分组和互斥

python复制import argparse

def main():
    parser = argparse.ArgumentParser(description="A simple greeting CLI tool")
    
    # 位置参数
    parser.add_argument('name', type=str, help="Your name")
    
    # 可选参数
    parser.add_argument('--age', type=int, default=N