Symfony命令隐藏需分两级：命令级用#[AsCommand(hidden: true)]并删除configure()方法；选项级在configure()中调用getDefinition()->getOption('name')->setHidden(true)，二者机制不同且不可混用。
想让 Symfony 命令不露面？不是删掉它，而是让它“存在但不可见”——关键在两个层级：命令本身隐藏、命令选项隐藏。两者机制不同，用错地方就白忙活。
命令整体隐藏：用 #[AsCommand(hidden: true)]
这是最干净彻底的方式，适用于内部脚本、CI 专用或灰度调试类命令。
- 必须使用 PHP 属性语法，写在命令类顶部：#[AsCommand(name: 'app:deploy:staging', hidden: true)]
- 同时删掉 configure() 方法——哪怕里面只有一行
$this->setDescription()，留着就会让 hidden 失效 - 描述文案直接写进属性：
description: '仅限部署流水线调用' - 该命令不会出现在
bin/console list或bin/console help中，连 shell 补全也不会提示
单个选项隐藏：setHidden(true) 必须在 configure() 中调用
适合需要保留命令可见性，但想把某些参数（如 --force-migration、--internal-token）从帮助文档里拿掉的场景。
- 不能链式调用：
->addOption('foo')->setHidden(true)是无效的 - 正确写法是先添加，再单独获取并设隐藏：
$this->getDefinition()->getOption('foo')->setHidden(true) - 必须放在 configure() 里，execute() 阶段调用完全没反应
- 用户仍可传入该选项，校验逻辑（如 required）照常生效，只是 help 里不显示
别踩这些坑
很多隐藏失败，其实卡在细节上：
- $hidden = true 在类属性里写没用——5.4+ 版本已废弃此方式，必须配合 AsCommand 属性
- 手动在 services.yaml 里注册命令时，
console.command标签会绕过 AsCommand，导致 hidden 不生效 - 隐藏了 required 选项却不提供默认值？运行时仍会报
MissingOptionsException，且错误信息里会暴露这个“看不见”的选项名 - .env.local 里配错格式（比如 DATABASE_URL= 后多一个空格），会导致命令启动失败，但错误提示可能不指向真实原因
什么情况下该隐藏，什么不该？
隐藏不是为了偷懒，而是分清使用边界：
- ✅ 推荐隐藏：CI 环境注入的密钥、开发期临时开关、灰度发布标记、数据库迁移覆盖开关
- ❌ 不该隐藏：普通用户需理解并选择的参数（如
--format=json）、影响业务逻辑主路径的必填项 - ⚠️ 谨慎隐藏：含敏感默认值的 required 选项（比如预设的数据库密码），容易引发误用或泄露
