先运行composer show --plugins（≥2.2）或composer global show确认插件是否已安装；若未出现，说明未成功安装，常见于权限不足、网络中断或插件已弃用；若报“not compatible with Composer 2”，则表明插件被识别但因API版本不匹配或proc_open/pcntl_signal被禁用而拒绝加载。
插件根本没被识别？先看 composer show --plugins 输出
运行 composer show --plugins（Composer ≥2.2）或 composer global show，确认插件是否真在已安装列表里。如果完全不出现，说明它压根没装成功——常见于全局安装时权限不足、网络中断导致下载不全，或插件本身已弃用（如 hirak/prestissimo 在 Composer 2 中被移除）。别急着改配置，先验证存在性。
Plugin xxx is not compatible with Composer 2 这类报错怎么定位
这类错误说明插件被识别了，但加载阶段被主动拒绝。原因分两层：
- 插件的
composer.json声明了不兼容的 Composer 版本约束（如"composer-plugin-api": "^1.0"），而你用的是 Composer 2.x - 插件内部调用了已被移除的 API，比如依赖
proc_open或pcntl_signal，但 PHP 环境里这些函数被禁用
验证函数可用性：php -r "var_dump(function_exists('proc_open'));" 和 php -r "var_dump(function_exists('pcntl_signal'));"。输出 bool(false) 就是它。
插件报错干扰主流程？用 --no-plugins 快速隔离
不是所有插件错误都会中断命令，有些会静默降级。但如果你怀疑某次 composer install 卡住或行为异常，加 --no-plugins 参数重试。如果问题消失，说明确实是插件引发；再逐个启用（composer config --global plugins.allow-list xxx）排查具体是哪个。
临时绕过信号处理缺失：设环境变量 SF_SKIP_SIGNAL_HANDLER=1 composer install，适用于 symfony/flex 类插件因 pcntl_signal 不可用而崩溃的场景。
本地开发中插件配置生效但线上失效？检查 composer.json 的 config.plugins 字段
Composer 2.2+ 支持显式声明插件白名单，格式为：
"config": {
"plugins": {
"allow-list": ["vendor/package", "other/plugin"]
}
}
这个字段必须写在项目根目录的 composer.json 顶层，不能嵌套在 require 或 scripts 下。漏掉它，CI/CD 流水线里即使插件已安装，也会被默认禁用——尤其在设置了 --no-plugins 安全策略的生产环境中。
注意：该配置只影响当前项目，不会覆盖全局 allow-list；反之，全局配置也不会自动继承到项目里。
