Composer 2.5+ 重构 composer list 输出：默认仅显示命令名，长描述需 --raw 或 --format=json 获取；插件命令自 v2.2+ 才纳入列表；--no-ansi 自 v2.3+ 支持；脚本别名不再出现在 list 中，应改用 composer run --list 或检查 composer.json。
composer list 输出结构在 v2.5+ 中被重构
Composer 2.5.0 起，composer list 默认不再显示所有命令的完整描述，而是只列出命令名（如 install、update），长描述被折叠到 --format=xml 或 --raw 才能获取。这不是 bug，是 CLI 输出层的主动精简——目的是加快命令响应，尤其在 CI 中频繁调用时减少日志体积。
如果你的脚本依赖 composer list | grep "dump-autoload" 来判断命令是否存在，它在 v2.5+ 下仍能匹配，但若依赖 composer list | awk '{print $2}' 提取描述字段，就会失效，因为第二列不再是描述文本。
- 兼容写法：用
composer list --raw获取纯命令名列表（每行一个） - 需要描述时：改用
composer list --format=json，解析 JSON 中的description字段 - 避免硬切空格：不要用
cut -d' ' -f2-解析默认输出，v2.5+ 的对齐逻辑已移除
插件注册命令在 v2.2+ 后才出现在 composer list 结果中
Composer 插件通过实现 CommandProvider 接口注册自定义命令，但这些命令是否出现在 composer list 输出里，取决于插件 API 版本和 Composer 运行时行为。v2.2.0 是分水岭：此前插件需手动调用 $eventDispatcher->addListener() 注册事件，不生成命令；v2.2+ 引入 addCapability() 机制，只有插件声明了 "composer-plugin-api": "^2.2.0" 并正确返回 CommandProvider 实例，其命令才会被纳入 composer list。
常见误判：插件 composer.json 声明了 "composer-plugin-api": "^1.1.0"，却期望在 Composer 2.4 中看到它的命令——实际不会出现，也不会报错，只是静默忽略。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 验证方式：运行
composer diagnose，检查 “Plugin X is not compatible with Composer 2” 提示 - 调试技巧：在插件 activate() 方法里加
var_dump(get_class($this));，确认是否被加载 - CI 场景下务必指定 Composer 版本：用
COMPOSER_VERSION=2.4.4环境变量锁定，避免因基础镜像升级导致命令突然消失
composer list --help 在 v2.3+ 中新增 --no-ansi 支持
composer list --help 的帮助文本在 v2.3.0 前默认带 ANSI 颜色码，某些 CI 日志系统或旧版 shell 会把 \e[32m 这类转义序列原样输出，导致日志可读性差。v2.3+ 开始支持 --no-ansi 参数强制禁用颜色，且该参数可与 --help 组合使用：composer list --help --no-ansi。
注意：这个参数不是全局开关，必须显式传给 list 子命令本身，放在 composer 后无效（如 composer --no-ansi list --help 不生效）。
- 旧版本 workaround：用
composer list --help 2>/dev/null | sed 's/\x1b\[[0-9;]*m//g'清洗 ANSI 码 - 推荐做法：在脚本中统一加
--no-ansi，尤其用于生成文档或存档帮助文本 - 别依赖
TERM=dumb：部分容器环境不识别该变量，--no-ansi更可靠
自定义命令别名在 v2.5+ 中不再自动出现在 list 输出
通过 config.bin-dir 或 scripts 定义的 shell 别名（如 "scripts": {"ci:install": "composer install --no-dev"}）曾可在 composer list 中显示为 ci:install，但 v2.5+ 移除了对 script 别名的自动注册逻辑。现在只有真正由插件或 Composer 内置注册的命令才会出现。
这意味着：如果你的 CI 流水线靠 composer list | grep ci:install 判断脚本是否定义，v2.5+ 下会失败——它根本不会出现在输出里。
- 替代方案：用
composer run --list查看所有 scripts（v2.2+ 支持） - 更健壮的检测：直接检查
composer.json是否含对应 script 键，用jq -e '.scripts["ci:install"]' composer.json >/dev/null - 别混用：
composer run ci:install和composer ci:install是两回事，后者仅当命令被插件注册才有效
grep 都可能因版本跃迁而断裂。最稳妥的方式不是适配所有版本，而是明确锁定 COMPOSER_VERSION 并在 composer.json 的 config.platform 中声明目标版本范围。 
