打造高效自动化利器（Python命令行工具开发从零开始实战指南）

为什么选择 Python 开发 CLI 工具？

Python 语法简洁、生态丰富，且自带强大的标准库（如 argparse、os、subprocess 等），非常适合快速构建命令行界面（CLI）工具。通过 Python脚本自动化，你可以将繁琐操作一键完成。

第一步：认识 argparse 模块

argparse 是 Python 官方推荐用于解析命令行参数的标准库。它能自动生成帮助信息、处理参数类型、设置默认值等，是 CLI工具制作 的核心组件。

第二步：编写你的第一个命令行工具

我们来创建一个简单的文件重命名工具，支持批量将指定目录下的文件添加前缀。

import argparseimport osdef rename_files(directory, prefix):    """为指定目录下的所有文件添加前缀"""    if not os.path.exists(directory):        print(f"错误：目录 {directory} 不存在！")        return        for filename in os.listdir(directory):        old_path = os.path.join(directory, filename)        if os.path.isfile(old_path):            new_name = prefix + filename            new_path = os.path.join(directory, new_name)            os.rename(old_path, new_path)            print(f"已重命名: {filename} → {new_name}")if __name__ == "__main__":    parser = argparse.ArgumentParser(        description="批量为文件添加前缀的命令行工具"    )    parser.add_argument(        "-d", "--dir",        required=True,        help="要处理的目录路径"    )    parser.add_argument(        "-p", "--prefix",        default="new_",        help="要添加的前缀（默认为 'new_'）"    )        args = parser.parse_args()    rename_files(args.dir, args.prefix)

第三步：运行和测试工具

将上述代码保存为 rename_tool.py，然后在终端中运行：

python rename_tool.py --help

你会看到自动生成的帮助信息：

usage: rename_tool.py [-h] -d DIR [-p PREFIX]批量为文件添加前缀的命令行工具options:  -h, --help            show this help message and exit  -d DIR, --dir DIR     要处理的目录路径  -p PREFIX, --prefix PREFIX                        要添加的前缀（默认为 'new_'）

实际使用示例：

python rename_tool.py -d ./photos -p backup_

该命令会将 ./photos 目录下所有文件加上 backup_ 前缀。

进阶技巧：添加子命令与更复杂逻辑

对于功能更复杂的工具（如 git），可以使用 add_subparsers() 来实现子命令。例如：

parser = argparse.ArgumentParser()subparsers = parser.add_subparsers(dest='command')# 添加子命令 'rename'rename_parser = subparsers.add_parser('rename', help='重命名文件')rename_parser.add_argument('--dir', required=True)# 添加子命令 'list'list_parser = subparsers.add_parser('list', help='列出文件')list_parser.add_argument('--dir', required=True)args = parser.parse_args()if args.command == 'rename':    # 执行重命名逻辑    passelif args.command == 'list':    # 执行列出逻辑    pass

总结

通过本文，你已经掌握了使用 Python 开发命令行工具的基础技能。借助 argparse教程 中介绍的方法，你可以轻松构建出专业、易用的 CLI 工具。无论是自动化日常任务，还是为团队提供便捷脚本，Python命令行工具开发 都是一个值得掌握的核心能力。

赶快动手试试吧！从一个小工具开始，逐步扩展功能，你会发现 Python脚本自动化 的强大魅力。