OptionParser 已经在 Python 3.2 版本中被弃用，并在 Python 3.2+ 中被移除了。
（图片来源网络，侵删）
官方推荐使用 argparse 模块。argparse 功能更强大、更灵活,并且是处理命令行参数的现代标准。
我的回答会分为两部分：
- 为什么以及如何使用
argparse（推荐）：这是你现在应该学习和使用的方法。 OptionParser的工作原理（作为历史知识）：如果你需要维护旧的 Python 2 代码，或者想了解历史,这部分会很有用。
第一部分：使用 argparse（现代方法）
argparse 模块可以让你轻松地编写用户友好的命令行接口，你的程序可以定义它需要接受的参数，argparse 会自动生成帮助信息和使用说明,并解析用户提供的参数。
核心步骤
使用 argparse 通常遵循以下四个步骤：
（图片来源网络，侵删）
- 导入模块：
import argparse - 创建解析器对象：
parser = argparse.ArgumentParser(description='程序描述信息') - 添加参数：使用
parser.add_argument()方法定义程序接受的命令行参数。 - 解析参数：
args = parser.parse_args()，这会从sys.argv中解析参数,并返回一个包含参数值的对象。
示例1：一个简单的脚本
假设我们有一个脚本 greet.py,它接受一个名字和一个可选的问候语。
# greet.py
import argparse
# 1. 创建解析器对象
# description 会在 --help 的开头显示
parser = argparse.ArgumentParser(description="一个简单的问候脚本。")
# 2. 添加参数
# parser.add_argument('name', help='要问候的人的名字')
# positional argument (位置参数)，必需的
# parser.add_argument('--greeting', help='使用的问候语', default='Hello')
# optional argument (可选参数)，以 -- 开头，有默认值
# 更详细的参数定义
parser.add_argument('name',
type=str,
help='要问候的人的名字')
parser.add_argument('--greeting',
type=str,
default='Hello',
help='使用的问候语 (默认: Hello)')
# 3. 解析参数
args = parser.parse_args()
# 4. 使用参数
print(f"{args.greeting}, {args.name}!")
如何运行：
-
查看帮助：
$ python greet.py --help usage: greet.py [-h] [--greeting GREETING] name 一个简单的问候脚本。 positional arguments: name 要问候的人的名字 options: -h, --help show this help message and exit --greeting GREETING 使用的问候语 (默认: Hello)
-
基本用法（位置参数）：
（图片来源网络，侵删）$ python greet.py Alice Hello, Alice!
-
使用可选参数：
$ python greet.py Alice --greeting "Howdy" Howdy, Alice!
示例2：更复杂的用法
argparse 还支持更多高级功能，如互斥参数、布尔标志、文件输入输出等。
# advanced_script.py
import argparse
parser = argparse.ArgumentParser(description="一个高级的脚本示例。")
# 互斥参数组：--source 和 --target 不能同时使用
group = parser.add_mutually_exclusive_group(required=True)
group.add_argument('--source', help='指定源文件')
group.add_argument('--target', help='指定目标目录')
# 布尔标志 (action='store_true')
parser.add_argument('-v', '--verbose', action='store_true', help='显示详细输出')
# 可选的数值参数
parser.add_argument('--count', type=int, default=1, help='重复次数 (默认: 1)')
args = parser.parse_args()
if args.verbose:
print("详细模式已开启。")
if args.source:
print(f"处理源文件: {args.source}")
elif args.target:
print(f"处理目标目录: {args.target}")
for i in range(args.count):
print(f"执行操作... (第 {i+1} 次)")
如何运行：
# 查看帮助 $ python advanced_script.py --help # 使用 --source 和 -v $ python advanced_script.py --source data.txt -v 详细模式已开启。 处理源文件: data.txt 执行操作... (第 1 次) # 使用 --target 和 --count $ python advanced_script.py --target /tmp --count 3 处理目标目录: /tmp 执行操作... (第 1 次) 执行操作... (第 2 次) 执行操作... (第 3 次) # 错误：互斥参数同时使用 $ python advanced_script.py --source a.txt --target b.txt usage: advanced_script.py [-h] (--source SOURCE | --target TARGET) [-v] [--count COUNT] advanced_script.py: error: argument --target: not allowed with argument --source
argparse 的核心优势在于它自动生成了帮助信息，并在参数使用不当时给出清晰的错误提示,这大大提升了用户体验。
第二部分：OptionParser 的工作原理（历史知识）
OptionParser 是 Python 2 标准库 optparse 模块中的一个类，它的设计理念与 argparse 类似,但功能上更简单。
核心步骤
- 导入模块：
from optparse import OptionParser - 创建解析器对象：
parser = OptionParser() - 添加选项：使用
parser.add_option()方法。 - 解析参数：
options, args = parser.parse_args()，它会返回一个包含选项值的options对象和一个包含位置参数的列表args。
示例：与 argparse 对比
让我们用 optparse 重写第一个 greet.py 的例子。
# greet_optparse.py
from optparse import OptionParser
# 1. 创建解析器对象
parser = OptionParser(description="一个简单的问候脚本。")
# 2. 添加选项
# action='store' 表示存储参数的值
# dest='name' 指定存储到的属性名
parser.add_option('-n', '--name', dest='name', help='要问候的人的名字')
parser.add_option('-g', '--greeting', dest='greeting', default='Hello', help='使用的问候语 (默认: Hello)')
# 3. 解析参数
# parse_args() 返回两个值: options 对象和 args 列表
options, args = parser.parse_args()
# 4. 使用参数
# 通过 options 对象的属性访问值
print(f"{options.greeting}, {options.name}!")
如何运行：
-
查看帮助：
$ python greet_optparse.py --help Usage: greet_optparse.py [options] 一个简单的问候脚本。 Options: -h, --help show this help message and exit -n NAME, --name=NAME 要问候的人的名字 -g GREETING, --greeting=GREETING 使用的问候语 (默认: Hello) -
基本用法：
# 注意：在 optparse 中，位置参数需要用 add_option 的 action='store' 或 'append' 来处理， # 或者更常见的是，所有参数都定义为选项，上面的例子中 --name 是必需的。 $ python greet_optparse.py --name Bob Hello, Bob! $ python greet_optparse.py -n Charlie -g "Hi there" Hi there, Charlie!
OptionParser 与 argparse 的主要区别
| 特性 | optparse.OptionParser (旧) |
argparse.ArgumentParser (新) |
|---|---|---|
| Python 版本 | Python 2 | Python 3.2+ (推荐) |
| 参数类型 | 严格区分 选项 (options, 如 --foo) 和 位置参数 (arguments, 如 bar)。 |
统一使用 add_argument，通过 nargs 和 action 等控制行为，概念更统一。 |
| 帮助信息 | 基本的帮助信息，格式固定。 | 非常强大，自动生成格式化的帮助信息，支持分组、描述等。 |
| 子命令 | 不支持。 | 原生支持，通过 add_subparsers() 轻松实现类似 git 的子命令结构。 |
| 类型转换 | 需要手动指定 type，但不如 argparse 方便。 |
内置对多种类型的支持 (int, float, file, choice 等)，通过 type= 参数指定。 |
| 动作 | action 类型较少，如 store, store_true, append。 |
action 非常丰富，包括 store, store_true, append, count, extend, help, version 等。 |
| 错误处理 | 错误信息相对简单。 | 错误信息更清晰、更友好，能准确指出问题所在。 |
| 互斥参数 | 通过 OptionGroup 或 OptionParser.set_conflict_handler() 实现，比较麻烦。 |
通过 add_mutually_exclusive_group() 方法，非常直观。 |
总结与建议
argparse (推荐) |
optparse (历史) |
|
|---|---|---|
| 状态 | 当前标准，积极维护 | 已弃用，不推荐新项目使用 |
| 功能 | 强大、灵活、功能全面 | 基础功能，相对有限 |
| 易用性 | 学习曲线稍陡，但一旦掌握非常高效 | 对于简单脚本可能更容易上手，但复杂场景处理困难 |
| 未来 | Python 生态的未来 | 仅用于维护旧代码 |
给你的建议：
- 对于所有新项目，请务必使用
argparse，它是行业标准，功能强大,能让你写出健壮且用户友好的命令行工具。 - 如果你在维护一个旧的 Python 2 项目，并且它使用了
optparse，那么在没有充分理由重构的情况下，可以继续使用它，但如果计划迁移到 Python 3，argparse是必经之路。 - 如果你在学习 Python，请直接学习
argparse，跳过optparse,把精力花在当前和未来的技术上更有价值。
