如何使用Symfony Console模块构建自定义命令行工具？

本文共计1038个文字，预计阅读时间需要5分钟。

必须让Symfony知道你的命令类存在，否则在命令列表中永远看不到它。在Symfony 5.4中，默认使用自动发现机制，但需要满足以下两个条件：

常见错误现象：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。