optionsresolver 处理命令行参数比手写 inputinterface 校验更安全可维护，因其支持类型断言、默认值合并、依赖规则和标准化转换；而原生 inputinterface 仅提供原始输入，缺乏内置校验与转换能力。
直接用 OptionsResolver 处理命令行参数的配置输入，比手写 $input->getArgument() 和 $input->getOption() 的校验逻辑更安全、可维护性更高——尤其当选项变多、有依赖关系或需类型转换时。
为什么不能只靠 InputInterface 做校验
原生 InputInterface 提供的是“原始输入”，它不负责类型断言、默认值合并、条件依赖或格式标准化。比如你期望一个 --timeout 是整数，但用户传了 "30s"；又或者 --format 必须是 json 或 csv，但没做枚举限制——这些都得自己写 if/else，容易漏、难复用。
- 没有内置类型转换（如字符串转
\DateTime） - 无法声明“当
--dry-run为 true 时，--force必须为 false”这类互斥规则 - 默认值分散在
configure()和execute()里，不易集中管理
在 Command 中集成 OptionsResolver 的标准写法
把 OptionsResolver 实例化和配置逻辑封装在 execute() 开头，而不是塞进 configure()——因为后者只管定义接口，不参与运行时解析。
- 在
execute()方法内创建$resolver = new OptionsResolver() - 用
setDefaults()声明所有可能的键及其默认值（包括从$input读取的原始值） - 用
setAllowedTypes()限定类型，例如setAllowedTypes('port', 'int') - 用
setAllowedValues()限制枚举，例如setAllowedValues('format', ['json', 'xml']) - 调用
$resolver->resolve($rawOptions)得到清洗后的$options数组
示例片段：
use Symfony\Component\OptionsResolver\OptionsResolver;
protected function execute(InputInterface $input, OutputInterface $output): int
{
$rawOptions = [
'host' => $input->getOption('host'),
'port' => $input->getOption('port'),
'timeout' => $input->getOption('timeout'),
];
$resolver = new OptionsResolver();
$resolver->setDefaults([
'host' => '127.0.0.1',
'port' => 8080,
'timeout' => 30,
]);
$resolver->setAllowedTypes('port', 'int');
$resolver->setAllowedTypes('timeout', ['int', 'float']);
$resolver->setAllowedValues('port', fn($v) => $v > 0 && $v resolve($rawOptions);
// 后续逻辑只操作 $options，不再碰 $input
}
常见坑：延迟默认值与标准化器的误用场景
OptionsResolver 的 setDefault() 支持闭包，但它在 resolve() 时才执行；而 setNormalizer() 更适合做预处理，比如把字符串路径转成 realpath()。这两者常被混淆。
- 别在
setDefault()闭包里做 I/O 操作（如读文件），它可能被多次调用 -
setNormalizer('config', ...)应该只做无副作用转换，比如 trim()、strtoupper()、new DateTime() - 如果标准化逻辑依赖其他选项（如 “当
env=prod时，log_level默认为error”），要用setNormalizer()+$options参数，而不是硬编码默认值 - 错误信息里的键名是
OptionsResolver内部使用的，不是$input的 option 名，调试时注意对齐
真正麻烦的不是写几行 setAllowedTypes()，而是当业务规则变复杂后，把验证逻辑从命令方法里抽离出来、独立测试——这时候 OptionsResolver 的配置本身就成了可单元测试的一等公民，而不是散落在 execute() 里的 if 判断堆。
