直接答案：用 setHidden(true) 方法，且必须在 configure() 里调用，不能等到 execute() 阶段。该方法仅隐藏选项的文档可见性，不影响实际解析与校验，用户仍可传入；必须通过 getDefinition()->getOption('name')->setHidden(true) 调用，不可链式调用；隐藏后 help 和 list 不显示，但 JSON 输出仍包含且 hidden 字段为 true。
如何让 Symfony 命令选项不显示在 php bin/console help 中
直接答案：用 setHidden(true) 方法，且必须在 configure() 里调用，不能等到 execute() 阶段。
这个操作不是“禁用选项”，而是隐藏其文档可见性——用户仍可传入该选项，但 --help 输出里不会列出它，也不会出现在自动生成的命令摘要中。
-
setHidden(true)必须在configure()方法内对InputOption实例调用，比如：$this->getDefinition()->getOption('foo')->setHidden(true) - 不能在
execute()里调用，那时定义已冻结，调用无效且无报错 - 隐藏后，
bin/console list和bin/console help xxx都不会显示该选项，但bin/console xxx --foo=bar依然能正常解析 - 注意：Symfony 不支持对单个选项单独调用
setHidden()的链式写法（如->addOption(...)->setHidden(true)），必须先添加再查出再设
为什么 addOption(..., null, InputOption::VALUE_NONE) 不能替代隐藏
很多人误以为把选项设为 VALUE_NONE 或省略 $mode 就能“让它不显眼”，其实完全无关——VALUE_NONE 只控制是否接受参数值，不影响帮助文本展示。
真正决定是否出现在 help 列表里的，只有 isHidden() 内部状态，而这个状态只能靠 setHidden() 修改。
-
addOption('debug', 'd', InputOption::VALUE_NONE)：会照常显示在 help 里，只是没参数提示 -
addOption('internal-key', null, InputOption::VALUE_REQUIRED)：哪怕没 shortcut，只要没setHidden(true)，就会列出来 - 隐藏选项常用于 CI 脚本注入、调试开关、灰度标记等不希望普通用户看到的参数
隐藏选项后，InputOption::isRequired() 是否还生效
是的，仍然生效。隐藏 ≠ 移除，它只是 UI 层的遮罩，校验逻辑照常运行。
如果一个被隐藏的选项设置了 InputOption::VALUE_REQUIRED 且未提供，命令启动时仍会抛出 MissingOptionsException，错误信息里甚至会包含该选项名——也就是说，用户看不到它，但输错时反而更困惑。
- 务必搭配文档或内部约定说明隐藏选项的存在和用法
- 避免对
isRequired()的隐藏选项暴露敏感默认值（比如数据库密码） - 若需“有则用、无则跳过”，请用
InputOption::VALUE_OPTIONAL+ 显式判空，而非依赖隐藏来绕过校验
Symfony 7.2 的兼容细节与陷阱
7.2 对 setHidden() 的行为没有变更，但要注意两点底层变化：一是 InputDefinition 默认不再自动 clone，二是 getDefinition() 返回的是命令自身持有的实例，直接修改即可；二是部分 IDE 插件或静态分析工具可能尚未识别隐藏状态，导致代码补全仍提示该选项。
- 别在多个命令间复用同一个
InputOption实例，否则隐藏状态会污染其他命令 - 如果用了命令继承（比如 BaseCommand → ChildCommand），子类中调用
getDefinition()拿到的是父类定义副本，需确保在最终命令的configure()中执行setHidden() - 测试时建议加断言：
$this->assertTrue($command->getDefinition()->getOption('xxx')->isHidden())
最易忽略的一点：隐藏选项不会从 bin/console list --format=json 的输出中消失——JSON 格式仍会完整返回所有选项，包括 "hidden": true 字段。如果你的自动化工具依赖这个接口做参数发现，得额外过滤。
