Composer插件必须实现CommandProviderInterface接口，否则无法被识别为命令提供者；getCommands()须返回BaseCommand实例数组，且extra.command-provider需配置全限定类名并声明composer-plugin-api:^2.0。
Composer插件必须实现 CommandProviderInterface
不实现这个接口，Composer根本不会识别你的类是命令提供者。它不是靠命名约定或自动扫描发现命令的，而是通过 Composer 自身的插件加载机制，在初始化时调用插件类的 getCommands() 方法——而这个方法正是 CommandProviderInterface 强制要求的。
常见错误现象：composer my:command 报错 Command "my:command" is not defined，但插件已安装、类文件也存在——大概率就是忘了 implements 这个接口，或者 getCommands() 返回了空数组或非 Command 实例。
- 必须在插件主类中
implements ComposerPluginCommandProviderInterface -
getCommands()必须返回array，每个元素是继承自SymfonyComponentConsoleCommandCommand的实例 - 不要试图在
activate()里注册命令；Composer 只认getCommands()
自定义命令类要继承 BaseCommand 而非裸写 Command
直接 extends SymfonyComponentConsoleCommandCommand 会丢失对 $this->getComposer()、$this->getApplication()->getComposer() 等关键能力的便捷访问，而且无法自动获得 Composer 的 IO、config、io 等上下文。
正确做法是继承 ComposerCommandBaseCommand（Composer 自带），它已经帮你桥接好了所有依赖。否则你得手动注入 Composer 实例，还容易和 Composer 内部生命周期冲突。
-
use ComposerCommandBaseCommand;是必须的 - 命令类中可用
$this->getComposer()拿到当前项目 composer 实例 - 不要重写
initialize()去手动 fetch Composer ——BaseCommand已内置处理 - 若用 Symfony Console v5+ 独立包开发，注意 Composer 当前（2.x）仍基于 Symfony Console v4，接口有细微差异
composer.json 中的 extra.command-provider 必须写全限定类名
这个配置项告诉 Composer：“去加载这个类，并调用它的 getCommands()”。如果路径或命名空间写错，Composer 不报错，但静默跳过——命令就是不出现。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
典型错误：写成 "MyCommand" 或 "src/MyCommand"，实际需要的是完整命名空间+类名，比如 "Acme\ComposerPlugin\MyCommandProvider"。
- 类文件必须可被 Composer 自动加载（即符合 PSR-4，且
autoload配置正确） -
extra.command-provider的值不能带.php后缀，也不能是相对路径 - 插件包类型必须是
composer-plugin，否则extra字段不会被解析 - 运行
composer install后，检查vendor/composer/autoload_psr4.php是否真包含了你的命名空间
调试命令不生效时，优先检查 composer-plugin-api 版本兼容性
Composer 插件不是“写了就能跑”。从 Composer 1.x 升到 2.x 后，插件 API 有 breaking change：比如 PluginInterface::activate() 的第二个参数从 ComposerComposer 变成了 ComposerIOIOInterface，而命令提供逻辑移到了独立接口。
如果你的插件声明支持 "composer-plugin-api": "^1.0"，但在 Composer 2.2+ 下运行，getCommands() 根本不会被调用——因为新版只认 ^2.0。
- Composer 2.x 插件必须声明
"composer-plugin-api": "^2.0" - 对应 require 的
composer/composer版本应为^2.0（开发时） - 运行
composer plugin list可看到已启用插件及其 API 版本，这是最直接的验证方式 - 别信 “本地测试没问题” —— CI 或生产环境用的 Composer 版本可能不同
插件机制本身不复杂，但 Composer 对加载时机、接口契约、版本对齐极其敏感。一个字母大小写不对，或一个命名空间少写一级，命令就彻底隐身——它不会报错，只会安静地不存在。
