当多个 Composer 包声明同名 bin 命令时，后安装的包会覆盖前者，导致执行的可能是错误版本；可通过自定义 bin 路径、创建封装脚本或使用项目级命令调度来避免冲突。
当使用 Composer 安装依赖包时，不同包可能定义了相同名称的 bin 命令（例如都提供了 phpunit 或 psysh），这会导致可执行文件冲突。Composer 本身不会自动重命名或合并这些命令，但提供了一些机制来帮助开发者处理这类问题。
1. Composer 的 bin 冲突处理机制
Composer 在安装依赖时，会将每个包中 bin 目录下的可执行脚本链接到项目根目录的 vendor/bin 目录下。如果多个包声明了同名的 bin 文件：
- 后安装的包会覆盖已存在的同名文件
- 实际执行的是最后写入的那个脚本
- 这种覆盖行为没有警告提示，容易引发误操作
这意味着如果你同时引入两个都提供 phpunit 的包，最终 vendor/bin/phpunit 指向的是哪个版本，取决于它们的安装顺序或依赖解析结果，可能会导致意外运行错误的工具版本。
2. 手动配置 bin 文件避免冲突
可以通过在 composer.json 中显式指定 bin 路径来规避命名冲突。例如，为不同版本的工具起别名：
{
"require": {
"phpunit/phpunit": "^9.0",
"mycompany/test-runner": "^2.0"
},
"config": {
"bin-compat": "full"
},
"bin": [
"bin/my-phpunit", // 自定义入口指向特定实现
"bin/run-tests" // 包装脚本控制调用逻辑
]
}
然后手动创建包装脚本（如 bin/my-phpunit）并指定具体要执行的命令，绕过 vendor/bin 的直接映射。
3. 使用本地 wrapper 脚本进行调度
更推荐的做法是不直接使用冲突的 bin 名称，而是编写封装脚本：
- 创建
scripts/run-phpunit-9.sh和scripts/run-phpunit-10.sh - 在脚本中明确调用对应路径下的真实二进制文件，如：
vendor/package-a/vendor/bin/phpunit --version - 通过项目级命令管理器（如 make、just 或 npm scripts）统一调用
这样即使 bin 文件被覆盖，你仍可通过精确路径访问所需工具。
4. 查看哪些包提供了 bin 命令
可以运行以下命令查看当前项目中所有被安装的 bin 文件来源：
composer show --executables
输出会列出每个包提供的可执行文件及其目标路径，有助于识别潜在冲突。
也可以结合：
ls -la vendor/bin
检查实际文件链接情况，确认是否存在覆盖现象。
基本上就这些。Composer 不会主动解决 bin 冲突，需要开发者通过命名规范、脚本封装或人工干预来确保正确执行预期命令。关键是不要假设 vendor/bin/name 一定来自某个特定包，尤其是在多源混合场景下。
