Composer如何编写自定义指令并在本地终端直接调用（扩展命令）-composer-PHP中文网

不能。scripts 中定义的命令（如 "dev:start"）不会注册为 composer cli 命令，不会出现在 composer list 中，也不能用 composer dev:start 调用，只能通过 composer run dev:start 执行；要使其出现在 composer list 中，必须开发 type 为 "composer-plugin" 的插件，实现 commandproviderinterface 并正确配置 autoload 和 extra.command-provider。

composer如何编写自定义指令并在本地终端直接调用（扩展命令）

scripts 能不能直接当扩展命令用

不能。你在 composer.json 的 scripts 里写的 "dev:start" 或 "test:unit"，永远不会出现在 composer list 输出里，也不能用 composer dev:start 直接调用——它只是脚本别名，不是真正的 Composer 命令。

常见错误现象：composer dev:start 报错 Command "dev:start" is not defined，但 composer run dev:start 却能跑通。这不是环境问题，是机制差异：scripts 是运行时触发的 shell/PHP 调用，不注册 CLI 命令。

scripts 适合一次性自动化任务（如构建、清理、跑测试），不需交互或复杂参数解析
若需要带选项（--force）、子命令（myplugin:setup init）、自动补全或出现在 composer list，必须走插件路径
scripts 中的 PHP 回调（如 "MyClass::run"）必须已声明在 autoload 里，且第一行得手动 require __DIR__ . '/vendor/autoload.php';

怎么让自定义命令出现在 composer list 中

只有 type: "composer-plugin" 包 + 实现 Composer\Plugin\CommandProviderInterface 才会被扫描到。关键不在“写个类”，而在“被 Composer 正确加载”。

Discussion Composer

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

下载

composer.json 必须有 "type": "composer-plugin" 和 "require": {"composer-plugin-api": "^2.0"}
入口类（如 MyPlugin\Plugin）必须实现 getCapabilities()，返回 [CommandProviderCapability::class]
extra.command-provider 必须填全限定类名，例如 "Acme\MyPlugin\MyCommandProvider"，不能漏命名空间，也不能带 .php
该 provider 类的 getCommands() 必须返回 Composer\Command\BaseCommand 实例数组，不是字符串、不是未实例化的类名
插件必须已安装：本地开发需通过 repositories 指向路径，再 composer require --dev acme/my-plugin；全局插件用 composer global require acme/my-plugin

BaseCommand 和 Symfony Command 的区别在哪

别继承 Symfony\Component\Console\Command\Command。Composer 的命令上下文（$this->getComposer()、$this->getIO()）只在 Composer\Command\BaseCommand 中预置好。

继承 BaseCommand 后，可直接用 $this->getComposer()->getPackage() 获取当前项目信息
$input->getOption('verbose') 会自动对接 Composer 的全局 -v 参数，不用自己 parse
若硬上 Symfony Command，就得手动注入 Composer 实例，还容易和 Composer 内部事件生命周期冲突（比如在 execute() 里调 composer install 可能锁文件死锁）
Composer 2.x 当前绑定的是 Symfony Console v4，独立引入 v5+ 的包可能导致接口不兼容（如 configure() 返回类型）

本地开发调试插件为什么命令不出现

最常踩的坑不是代码写错，而是插件根本没被 Composer 加载——它静默跳过，不报错也不提示。

运行 composer show --plugin（Composer 2.2+）确认插件是否列在启用列表中；若没有，说明 extra.command-provider 路径错、autoload 没生效、或构造函数抛了异常
插件类的 __construct() 或 activate() 里任何未捕获异常（如文件不存在、配置缺失），都会导致 Composer 静默忽略整个插件
本地路径开发时，repositories 的 type 必须是 path，且路径值要绝对或相对于 composer.json，例如 "../my-composer-plugin"
改完代码后必须运行 composer dump-autoload（如果插件本身用了 PSR-4），否则 extra.command-provider 指向的类找不到