Symfony 5.4+ 中 $hidden = true 无效是因为必须配合 #[AsCommand(hidden: true)] 使用，且需禁用 configure() 方法；旧版需 public $hidden = true 或 setHidden(true) 在 configure() 中调用。
Symfony命令类里设置hidden属性无效？
直接在命令类里写protected static $defaultName = 'app:my-command';后加protected $hidden = true;，运行php bin/console list依然能看到——这不是bug，是 Symfony 5.4+ 的行为变更。从 5.4 开始，$hidden 属性必须配合 AsCommand 属性使用，且仅在启用 Attribute-based 命令注册时生效。
-
AsCommand是 Symfony 5.4 引入的替代configure()的声明式方式，不启用它，$hidden就被忽略 - 确保你没在
config/services.yaml里关掉自动命令发现：App\Command\命名空间必须被扫描（默认开启） - 如果用了
console.command标签手动注册，AsCommand和$hidden都不会起作用
用AsCommand 属性隐藏命令的正确写法
核心就两点：加属性、删旧方法。不需要重写 configure()，也不需要手动调用 setHidden(true)。
- 类顶部加
#[AsCommand(name: 'app:my-command', hidden: true)] - 删掉原来的
configure()方法（哪怕里面只有一行$this->setDescription(...)） - 描述文案改用属性参数：
#[AsCommand(name: 'app:my-command', description: '干啥用的', hidden: true)] - 如果仍需动态逻辑（比如根据环境决定是否隐藏），
AsCommand不适用，得退回configure()+$this->setHidden($this->getApplication()->getEnvironment() !== 'prod')
#[AsCommand(
name: 'app:debug-only',
description: '仅供开发环境使用的调试命令',
hidden: true
)]
class DebugOnlyCommand extends Command
{
// 不要 configure() 方法
}
为什么setHidden(true) 在configure() 里也失效？
不是代码写错了，而是调用时机问题。Symfony 在构建命令列表前，会先实例化所有命令并调用 configure()，但此时 $this->getApplication() 还未完全初始化，setHidden() 调用会被静默忽略。
- 安全做法：在
configure()里只设名字和描述；隐藏逻辑挪到execute()开头做判断并抛出LogicException（但这只是“运行时报错”，命令仍会出现在list输出里） - 真正想“彻底隐藏”，只能靠
AsCommand(hidden: true)或服务配置中移除该命令的注册 - 注意：CLI 参数补全（如 bash/zsh 补全）也会读取
list输出，hidden: true同样让它不出现在补全建议中
兼容旧版本 Symfony（
没有 AsCommand 属性，就只能靠传统方式，但要注意写法细节。
- 在
configure()最后一行加$this->setHidden(true);（必须在parent::configure()之后、且不能漏掉分号） - 确保命令类没被
console.command标签重复注册，否则容器会创建两个实例，隐藏状态可能不一致 - Symfony 4.4–5.3 中
$hidden属性本身有效，但必须是public，且要在类定义里直接赋值：public $hidden = true;（不是protected）
hidden 就形同虚设。 
