Composer不检测vendor/bin同名命令冲突，按依赖解析顺序硬链接覆盖，导致CI与本地行为不一致；可通过ls -l查看软链归属、grep手动溯源，或用composer-bin-plugin隔离多版本、自建封装脚本精确调用。
vendor/bin 下的同名 bin 命令会被后安装的包覆盖
Composer 不做冲突检测，只按依赖解析顺序把 bin 脚本硬链接到 vendor/bin/。比如 phpunit 被两个包同时声明，最终执行的是最后安装的那个——你根本不知道它来自哪个包、对应什么版本。
这种覆盖无声无息，没有警告，但后果严重：CI 跑测试时用的可能是旧版 phpunit，本地开发却用新版，行为不一致直接导致“在我机器上能跑”类问题。
- 执行
ls -l vendor/bin/phpunit可看到软链指向哪个包的bin/目录 -
composer show --tree无法反映 bin 文件归属，得靠grep bin -r vendor/* --include="composer.json"手动查 - 删掉
vendor重装，顺序可能变，phpunit指向就可能切换
用 composer-bin-plugin 给工具建独立环境
插件 bamarni/composer-bin-plugin 的核心价值不是“改名字”，而是隔离：每个工具在自己独立的 vendor 子目录里装依赖，互不干扰。
它不修改原有 vendor/bin，而是在项目根目录生成 bin/（可自定义），里面放带环境前缀的脚本，比如 bin/phpunit9、bin/phpunit10，各自调用自己那一套依赖。
- 安装：
composer require --dev bamarni/composer-bin-plugin - 配置（可选）：
"config": {"bin-dir": "bin"}确保命令输出到干净目录 - 声明工具：
"require-dev": {"phpunit/phpunit": "^9.6"}+"scripts": {"phpunit9": "phpunit"}，插件会自动映射为bin/phpunit9 - 多个版本共存时，各自
composer.json分开管理，不会互相污染
手动创建封装脚本绕过 vendor/bin 映射
如果你只需要几个关键命令、不想引入新插件，最轻量的办法是放弃 vendor/bin 的自动链接，自己写薄封装。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
本质是把调用逻辑收口：不再依赖 Composer 自动 symlink，而是用明确路径调用特定包的脚本，并传参透传。
- 在项目根目录建
bin/my-phpunit，内容：#!/usr/bin/env php <?php require __DIR__ . '/vendor/autoload.php'; passthru('php ' . __DIR__ . '/vendor/phpunit/phpunit/phpunit ' . implode(' ', array_slice($argv, 1))); - 给脚本加执行权限：
chmod +x bin/my-phpunit - 在
composer.json的bin字段显式列出："bin": ["bin/my-phpunit"]，这样composer install会把它软链进vendor/bin/（但你实际用的是封装层） - 注意：封装脚本里必须用绝对路径调用目标二进制，不能依赖
$PATH或相对vendor/bin
别名机制对 bin 冲突完全无效
as 别名只作用于版本解析阶段，影响的是依赖树构建和 composer.lock 记录的版本号，它**不改变 bin 文件名、不生成新命令、不干预 vendor/bin 的链接逻辑**。
有人试过写 "phpunit/phpunit": "9.6.15 as 10.0.0"，结果发现 vendor/bin/phpunit 还是被覆盖，且依然指向 v9 的脚本——别名没让 Composer 多生成一个 phpunit10，也没阻止覆盖发生。
真正要解决 bin 冲突，只能靠路径隔离（plugin）、手动封装（脚本）、或彻底禁用某包的 bin 声明（改其 composer.json 的 bin 字段为空数组，再 composer update）。
最容易被忽略的是：bin 冲突和类名冲突是两回事，别名、PSR-4 映射、autoload 配置全都不管 bin 命令这档事——它们只管 PHP 类怎么加载，不管 shell 命令怎么命名。
