在 Symfony 中注册新 console 命令需满足：类置于 src/Command/ 下且以 Command 结尾；configure() 中调用 setName() 并正确定义参数/选项；execute() 签名严格为(InputInterface $input, OutputInterface $output)，返回 int，用 $output->writeln() 输出。
如何在 Symfony 项目中注册一个新 console 命令
必须让 Symfony 知道你的命令类存在，否则 php bin/console 列表里永远看不到它。Symfony 5.4+ 默认用自动发现机制，但前提是类满足两个条件：放在 src/Command/ 目录下，且类名以 Command 结尾（如 GreetCommand）。
常见错误现象：php bin/console | grep greet 没输出，或者报错 Command "app:greet" does not exist —— 很可能是因为类没放对位置，或命名不规范。
- 确认类文件路径是
src/Command/GreetCommand.php，不是src/Console/或src/Commands/ - 类名必须是
GreetCommand，不能是GreetConsole或Greet - 如果用了旧版 Symfony（config/services.yaml 中加
App\Command\的 autoconfigure 和 autowire 配置
command 类里哪些方法是必须重写的
configure() 和 execute() 是唯二强制要实现的方法。前者定义命令名、描述、参数和选项；后者是实际执行逻辑的入口。
容易踩的坑：有人只写 execute()，忘了调 $this->setName()，结果命令注册后显示为 command:name（占位符），运行时报错 Cannot resolve command name。
-
configure()里必须调用$this->setName('app:greet')，名称里不能有空格，推荐用冒号分组 -
execute()必须返回int：0 表示成功，非 0（如 1）表示失败，否则 Symfony 会警告 “Command did not return an integer” - 别在
execute()里直接echo，要用$output->writeln()，否则颜色、格式化、测试 mock 全失效
怎么安全地读取用户输入的参数和选项
Symfony 不允许在 execute() 里用 $input->getArgument('name') 前不先声明——否则抛出 InvalidArgumentException：“The required argument 'name' is missing.”
参数（arguments）和选项（options）行为差异很大：参数按顺序绑定、不可省略（除非设为 InputArgument::OPTIONAL）；选项带 -- 前缀、全可选、支持缩写（如 -v）。
- 在
configure()中用$this->addArgument('name', InputArgument::REQUIRED, 'Who to greet?') - 选项用
$this->addOption('yell', 'y', InputOption::VALUE_NONE, 'Yell the greeting') - 获取时统一用
$input->getArgument('name')和$input->getOption('yell')，别混用getDefinition()->getArgument() - 注意
InputOption::VALUE_REQUIRED和InputOption::VALUE_OPTIONAL的区别：前者要求--file=xxx或--file xxx，后者允许--file单独出现
为什么命令执行完没输出，或者报错 “Too many arguments”
典型症状是输入 php bin/console app:greet Alice --yell 却提示 Too many arguments，或静默退出。根本原因通常是参数定义与实际传入不匹配，或 execute() 方法签名被改过。
Symfony 严格校验 execute(InputInterface $input, OutputInterface $output) 这个方法签名。哪怕多加一个默认参数（如 $debug = false），也会导致容器无法正确绑定，最终 fallback 到原始逻辑并丢弃参数。
- 确保
execute()方法签名完全一致，不要加类型提示以外的任何东西 - 检查是否误把参数写成选项（比如该用
addArgument()却用了addOption()），反之亦然 - 运行时加
-vvv查看 debug 日志，能暴露参数解析失败的具体位置 - 如果命令依赖服务（如
EntityManagerInterface），记得在构造函数里声明并启用 autowire，否则$this->getContainer()是危险的反模式
__construct() 里做重操作，也别假设类属性能在多次调用间保持状态。 
