Symfony命令选项需在configure()中用addOption()显式声明，如--limit对应$ input->getOption('limit')，名称严格匹配且无需下划线；短横线分隔为规范，内部下划线仅为存储映射，不参与调用。
Symfony 命令的选项（options）不是靠“加下划线”来实现的，而是通过在命令类中定义 configure() 方法，调用 $this->addOption() 显式声明。下划线（_）本身没有特殊含义，但 Symfony 内部约定：选项名推荐使用短横线分隔（kebab-case），如 --dry-run，对应 PHP 中的变量名可写为 $input->getOption('dry-run')；而 PHP 属性或方法名本身不能含短横线，所以底层存储键名常转为下划线格式（如 dry_run）——但这只是内部映射，你无需手动加下划线。
真正要做的，是按规范注册和使用选项。
如何正确定义一个命令选项
在自定义命令类（继承 Command）的 configure() 方法中：
protected function configure(): void
{
$this
->setName('app:process-tasks')
->setDescription('处理待办任务')
->addOption(
'limit', // 选项名（命令行用 --limit）
'l', // 短选项（可选，命令行可用 -l）
InputOption::VALUE_REQUIRED, // 必填值
'最大处理数量'
)
->addOption(
'force',
null,
InputOption::VALUE_NONE, // 无值型开关
'跳过确认提示'
);
}✅ 正确：
--limit 10或--limit=10
❌ 错误：--limit_10、--limit_with_underscore—— 这不会被识别为标准选项。
如何在 execute() 中读取选项值
protected function execute(InputInterface $input, OutputInterface $output): int
{
$limit = $input->getOption('limit'); // 注意：传入的是定义时的原始名 'limit'，不是 'limit_' 或 'limit-with-underscore'
$force = $input->getOption('force');
if ($force) {
$output->writeln('<info>强制模式已启用</info>');
}
// ... 执行逻辑
return Command::SUCCESS;
}-
getOption('xxx')的参数必须与addOption('xxx', ...)中第一个参数完全一致； - 不需要、也不应该手动添加下划线；Symfony 不会自动把
--dry-run转成dry_run键供你调用（除非你用旧版getDefinition()->getOptions()手动处理，但不推荐）。
常见误解澄清
-
下划线不是语法要求：
--cache-dir是合法选项名，对应$input->getOption('cache-dir')，不是'cache_dir'； -
YAML 配置里可能用下划线：比如
framework.cache.prefix_seed: 'my_app'，但那是配置项命名规范，和命令选项无关； -
实体类或路由 defaults 键名带下划线（如
'admin_user_id'）是另一套规则，仅适用于路由参数绑定或表单字段映射，不适用于命令行选项。
小技巧：支持布尔开关 + 值混合型选项
->addOption(
'verbosity',
'v',
InputOption::VALUE_OPTIONAL,
'设置日志详细程度（默认 info），可选: debug, info, warning, error',
'info'
)调用方式：
php bin/console app:process-tasks --verbosity=debug-
php bin/console app:process-tasks -v→ 使用默认值info php bin/console app:process-tasks -v=warning
这种灵活性靠 VALUE_OPTIONAL 实现，不是靠下划线。
不复杂但容易忽略。
