Composer中文环境下针对Composer-Plugin-API的版本兼容性排查-composer-PHP中文网

插件不加载的首要原因是未被 composer 注册或 composer-plugin-api 版本不兼容。需检查 autoload_plugins.php 是否含插件路径、composer.json 中 type 是否为 "composer-plugin"、psr-4 映射末尾是否有反斜杠、plugin-api 版本是否 ≥ "^2.2.0"，并以 composer install -v 输出为准验证激活。

composer中文环境下针对composer-plugin-api的版本兼容性排查

插件不加载？先看 `autoload_plugins.php` 里有没有它

插件逻辑没触发，八成不是代码写错了，而是根本没被 Composer 当插件加载——vendor/composer/autoload_plugins.php 这个文件就是“插件注册表”，它为空或不含你的类路径，说明整个加载链从第一步就断了。

删掉 vendor/composer/autoload_*.php 全部文件，再跑 composer dump-autoload，否则旧映射残留会掩盖真实问题
检查插件包的 composer.json 中 "type" 字段必须严格等于 "composer-plugin"（写成 "plugin" 或漏掉，直接忽略）
确认插件类在 autoload_classmap.php 里有记录：常见漏扫原因是 PSR-4 映射末尾缺反斜杠，比如 "My\Plugin\": "src/" ✅，而 "My\Plugin": "src/" ❌

`composer diagnose` 报 “Plugin X is not compatible with Composer 2” 怎么验证

这行提示不是警告，是结论。它意味着 Composer 已明确拒绝加载该插件，原因几乎总是 composer-plugin-api 版本声明不对。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

打开插件包的 composer.json，查 require 或 conflict 字段：如果只有 "composer-plugin-api": "^1.0"，或压根没写，那它就不支持 Composer 2
别信 "^2.0" —— 实际最低有效版本是 "^2.2.0"；"^2.0" 会导致静默跳过，且 composer diagnose 不报错，只在 composer install -v 输出里看不到 Loading plugin …
运行 composer show composer/composer | grep plugin-api 查你本地 Composer 提供的真实 API 版本（例如输出 plugin-api: 2.4.0），再比对插件声明是否覆盖该版本

插件已归档但又不能删？临时 fork 修改 `composer-plugin-api`

像 hirak/prestissimo 这类已停止维护的插件，官方不会发新版，但硬删可能影响构建速度或 CI 流程。fork 后改两处是最小侵入方案。

把 fork 后的 composer.json 中 "composer-plugin-api": "^1.0" 改成 "^2.2.0"（不是 ^2.0）
在项目根目录 composer.json 的 repositories 字段加一条：{"type":"vcs","url":"https://github.com/yourname/prestissimo"}
执行 composer update hirak/prestissimo，确保拉取的是你 fork 的分支；之后务必手动测试插件行为（比如 composer install -v 是否真出现 Activating plugin …）

为什么 `composer update --dry-run` 看不出插件问题

因为 --dry-run 根本不加载插件、不校验 composer-plugin-api、也不触发任何钩子——它只做依赖解析，而插件兼容性检查发生在“加载”阶段，这个阶段被完全跳过了。

真正排查要用 composer update --no-plugins --dry-run -v：关插件 + 开日志，能暴露第一个约束冲突点
如果报错含 Conclusion: don't install，立刻接 composer why-not vendor/package:version，比翻几百行红字快得多
别依赖 composer show --tree 判断插件是否生效——它只显示依赖树，不反映插件是否被激活；composer install -v 输出里的 Loading plugin … 和 Activating plugin … 才是唯一可信信号