bin-dir 是项目级优先的多层级配置，支持全局、用户、项目三级，项目级最常用；必须为绝对路径或以 $HOME 开头；需目录预先存在，且 PATH 需手动更新。
默认情况下，composer install 生成的可执行文件（如 phpunit、laravel、doctrine）会放在 vendor/bin/，但你可以用 bin-dir 改变这个位置 —— 它有效，但要注意作用范围和覆盖逻辑。
bin-dir 是全局配置还是项目配置？
bin-dir 可以在三个层级设置，优先级从高到低：项目 composer.json → 当前用户 auth.json 或 config.json（位于 COMPOSER_HOME）→ 全局 config.json。项目级最常用，也最安全。
- 项目级：直接写在
composer.json的config段里，只影响当前项目 - 用户级：
composer config --global bin-dir /usr/local/bin，会影响所有后续安装的项目（不推荐） - 注意：
bin-dir不支持相对路径（如./bin），必须是绝对路径或以$HOME开头的路径（Composer 2.2+ 支持$HOME展开）
如何在 composer.json 中正确配置 bin-dir
编辑项目根目录下的 composer.json，在 config 对象中添加 bin-dir 字段。修改后需重新运行 composer install 或 composer update 才会生效。
{
"require": {
"phpunit/phpunit": "^10.0"
},
"config": {
"bin-dir": "scripts"
}
}
- 执行
composer install后，phpunit将生成在scripts/phpunit，而非vendor/bin/phpunit - 该路径必须已存在，Composer 不会自动创建目录；如果不存在，安装会报错：
Could not create bin dir ... - 若
bin-dir指向系统PATH目录（如/usr/local/bin），要确保当前用户有写权限，否则安装失败
bin-dir 和 vendor-bin 的区别？为什么有时 symlink 失败？
Composer 实际使用的是 bin-dir + bin-compat 组合行为。bin-compat 默认为 auto，会尝试创建符号链接（symlink）；若失败（如 Windows 或无权限），则回退为 copy 模式。
- Windows 默认用 copy（非 symlink），所以改
bin-dir到非项目目录时，可能因权限或防病毒软件拦截导致失败 - 如果
bin-dir路径跨磁盘（如从C:\到D:\），Windows 下 symlink 必然失败，Composer 自动 fallback 到 copy，但 copy 后的二进制文件可能无法正确解析#!/usr/bin/env phpshebang（Linux/macOS 场景下更关键） - 检查当前行为：运行
composer config bin-compat，输出symlink/copy/auto
PATH 环境变量需要手动更新吗？
不需要 Composer 自动帮你加 PATH，但你得自己确保 shell 能找到新 bin-dir 下的命令。
- 如果设为
"bin-dir": "bin"（项目内），建议用./bin/phpunit显式调用，或在脚本中用$(pwd)/bin加入临时 PATH - 如果设为
"bin-dir": "/opt/myproject-bin"，需手动把该路径加入 shell 的PATH（如export PATH="/opt/myproject-bin:$PATH"），且要持久化到~/.bashrc或~/.zshrc - CI/CD 环境中，
bin-dir设为绝对路径更稳妥，避免因工作目录变化导致命令找不到
真正容易被忽略的是：改了 bin-dir 后，IDE（如 PHPStorm）的 CLI interpreter 或外部工具配置不会自动更新，得手动指向新的可执行文件路径；另外，某些依赖包的 installer 脚本（如 Laravel Installer）会硬编码查找 vendor/bin，此时仅改 bin-dir 不足以绕过限制。
