Composer 的 bin-dir 配置项用于自定义可执行二进制文件的安装路径，支持项目级配置（如 "bin-dir": "bin"）、全局配置（composer config -g）和临时覆盖（--bin-dir），需确保目录存在可写并更新 PATH 环境变量。

Composer 的 bin-dir 配置项用于指定项目中可执行二进制文件（如命令行工具）的安装路径。

它控制 vendor/bin 下的命令软链接或可执行文件存放位置

当你运行 composer require some/package，而该包在 composer.json 中声明了 "bin" 字段（例如 "bin": ["phpunit", "laravel"]），Composer 默认会把对应的可执行文件（或符号链接）放到 vendor/bin/ 目录下。通过配置 bin-dir，你可以把这个目录改成别的位置，比如 bin/ 或 .bin/。

如何自定义 bin-dir

有三种常用方式：

• 项目级配置（推荐）：在项目根目录的 composer.json 中添加：

执行 composer install 或 composer update 后，所有 bin 文件就会出现在项目根目录下的 bin/ 中。

• 全局配置：运行 composer config -g bin-dir /usr/local/bin，这样所有项目都会默认使用该路径（注意权限和系统 PATH 是否包含该路径）。
• 临时覆盖：用命令行参数，如 composer install --bin-dir=scripts，仅对当次命令生效。

注意事项和常见问题

自定义 bin-dir 后需注意：

• 确保目标目录存在且可写，否则 Composer 会报错；
• 如果改到项目外（如 /usr/local/bin），要注意避免权限冲突或覆盖系统命令；
• 修改后，记得把新路径加入 shell 的 $PATH（尤其是全局或非 vendor/bin 路径），否则终端无法直接运行这些命令；
• 某些 IDE 或工具（如 PHPStorm）可能默认只识别 vendor/bin，需手动配置路径。

基本上就这些。不复杂但容易忽略的是路径权限和环境变量同步——改完别忘了让 shell 知道新命令在哪。