hyperf的命令行工具和代码生成器是核心开发环节，非锦上添花；执行php bin/hyperf.php gen:command userimportcommand可快速生成带handle()和configure()的命令类，自动设$signature为空、$name为user:import，但需手动补充参数定义并确认注解扫描启用。
Hyperf 的命令行工具和代码生成器不是“锦上添花”的附加功能，而是日常开发中真正省时间、防手误的核心环节。只要用对方式，gen:command、gen:controller 这类命令能帮你跳过 80% 的模板代码和路径/命名约定错误。
怎么快速生成一个可用的命令类？
别手动写继承 Command 的骨架——直接用 gen:command。
- 执行
php bin/hyperf.php gen:command UserImportCommand，会在app/Command下生成带完整生命周期方法（handle()、configure()）的类 -
$name属性自动设为user:import（驼峰转短横），$description也已占位，改掉就行 - 如果项目启用了注解扫描（默认开启），这个命令会自动被识别，无需额外注册
- 注意：生成后别急着跑，先检查
$signature属性是否符合你的参数需求——它默认为空，不填就无法接收任何参数
为什么 gen:controller 生成的路由不生效？
常见原因是没配对使用注解或路由配置方式，框架根本没加载到这个控制器。
- 如果你用的是
#[Controller]注解，确保类文件在自动扫描路径内（默认是app/Controller），且config/autoload/annotations.php中启用了App\Controller命名空间扫描 - 如果走配置文件路由（
config/routes.php），生成的控制器不会自动写入路由表，必须手动补上Router::get('/user', 'App\Controller\UserController::index') - 生成时加
--prefix参数可预设前缀：php bin/hyperf.php gen:controller UserController --prefix=user，避免后续反复改注解 - 别忽略
AbstractController的依赖注入——生成的控制器默认继承它，但如果你删了构造函数或没调用parent::__construct()，$this->response等属性会是null
gen 命令支持哪些组件？怎么查全量列表？
不是所有组件都列在文档首页，有些得靠命令本身反查。
- 运行
php bin/hyperf.php gen:list或php bin/hyperf.php list gen，能看到全部可用生成器（截至 Hyperf 3.1，含gen:aspect、gen:job、gen:middleware等） -
gen:amqp-consumer和gen:amqp-producer生成后需确认config/autoload/amqp.php已启用对应配置，否则启动时报AMQP consumer not found -
gen:process生成的进程类默认不自动启动，要手动在config/autoload/processes.php中添加类名才能随服务启动 - 所有生成器都遵循统一规则：类名首字母大写，文件存入对应目录，命名空间按
App\Xxx自动推导——但如果你项目改过根命名空间（比如改成MyApp），就得提前在config/autoload/generate.php里调整namespace配置项
DevTool 组件装了但命令不识别？
多数是 autoloader 没刷新或配置未生效。
- 装完
hyperf/devtool后，必须运行composer dump-autoload，否则bin/hyperf.php找不到新命令 -
devtool默认只在dev环境启用，检查.env是否设了APP_ENV=dev；生产环境用APP_ENV=prod时，gen命令会被禁用 - IDE 配置（如
devtool.php中的'ide' => 'vscode'）不影响命令执行，只影响生成代码时的跳转链接，但配错会导致生成的注解路径失效 - 生成器模板可自定义，但改
config/autoload/generate.php里的template路径后，必须确保该 tpl 文件存在且语法合法，否则报Template not found而不是更具体的解析错误
最常被忽略的点：生成器只是起点，gen 出来的代码不等于开箱即用。尤其是涉及 AMQP、定时任务、进程管理这类需要显式注册或配置的组件，生成后务必核对对应 config 文件是否已启用、类名是否拼写一致、命名空间是否与 autoloader 匹配——这些地方出错，往往比写错一行逻辑更难排查。
