composer exec 优先调用 vendor/bin/ 下可执行文件，其次 fallback 到 composer.json 的 scripts；若 vendor/bin/xxx 存在（含 .bat/.sh），则忽略 scripts.xxx，验证方式为删除对应文件后观察报错行为。

composer exec 是 Composer 内置命令，不是插件，也不是别名——它能直接调用 vendor/bin/ 下的可执行文件，也能运行 composer.json 中定义的 scripts 里同名条目，但优先找二进制文件。

怎么判断 composer exec 调用的是 vendor/bin 还是 scripts？

Composer 会按固定顺序查找：

• 先查 vendor/bin/xxx 是否存在且可执行（含 .bat、.sh 或带 shebang 的 PHP 文件）
• 找不到才 fallback 到 composer.json 的 scripts 里是否有 "xxx": "..."
• 如果两者都存在，vendor/bin/xxx 永远胜出——哪怕你写 composer exec lint，而 vendor/bin/lint 是个空文件，它也不会去跑 scripts.lint

验证方式：删掉 vendor/bin/phpunit，再运行 composer exec phpunit，就会报错 Command "phpunit" is not defined；但如果只删 vendor/bin/lint，而 scripts.lint 存在，composer exec lint 就能正常跑起来。

为什么有时 composer exec xxx 报 “Command not found”？

这不是 Composer 报错，而是它没在 vendor/bin/ 找到对应文件。常见原因：

Discussion Composer

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

下载

• composer require --dev xxx/xxx 装了包，但该包没在 composer.json 的 "bin" 字段声明入口，比如某些工具只提供 PHP 类，不暴露 CLI 二进制
• 装的是全局包：composer global require phpunit/phpunit → 它不会出现在本地 vendor/bin/，composer exec 看不见
• vendor/bin/ 目录为空或没生成：没运行过 composer install 或 composer update，或者用了 --no-scripts 或 --no-bin-links
• Windows 下 vendor/bin/phpunit.bat 权限不对或被杀毒软件拦截，导致不可执行

如何让自定义脚本支持传参（比如 composer exec lint -- src/）？

直接写 "lint": "php-cs-fixer fix" 不行——composer exec lint -- src/ 里的 src/ 不会透传给 php-cs-fixer。必须显式用 $@ 或 %* 接收：

• Linux/macOS："lint": "@php vendor/bin/php-cs-fixer fix $@"
• Windows（跨平台项目慎用）："lint": "@php vendor/bin/php-cs-fixer fix %*"
• 更稳妥的做法是写一个 shell 包装脚本（如 bin/lint），然后在 scripts 里调用它："lint": "bin/lint"

注意：@php 是关键——它绕过系统 PATH 查找 PHP 解释器，避免 Windows 下找不到 .bat 或 Unix 下权限问题；不加它，composer exec lint 在某些 CI 环境可能直接失败。

composer exec 和直接 ./vendor/bin/xxx 有什么实际区别？

核心差异不在“能不能跑”，而在“跑得稳不稳”：

• ./vendor/bin/phpunit 是硬路径，Windows 下可能要写成 vendor\bin\phpunit.bat，CI 脚本一换平台就挂
• composer exec phpunit 自动选对后缀（.bat or .sh），还临时把 vendor/bin 加进 PATH，确保内部调用其他 bin 工具（如 phpcs 调 phpcbf）也不炸
• composer exec 会自动加载 vendor/autoload.php，某些依赖 autoloader 的脚本（比如自己写的 bin/deploy）不加这步可能 fatal error
• 但它不支持完整 TTY，像 psysh 或 laravel tinker 可能卡输入——这种场景老老实实 php vendor/bin/psysh

最易被忽略的一点：如果你的脚本本身依赖 $_SERVER['PWD'] 或当前工作目录行为，composer exec 默认在项目根目录运行，而手动执行时容易 cd 错位置，结果路径解析失败。