如何使用Composer config bin-dir修改二进制执行文件的存放目录？

bin-dir 是 Composer 配置项，指定可执行脚本安装路径，默认 vendor/bin；可项目级（composer.json）、全局级（composer config -g）或临时（--bin-dir）设置，修改后需重运行 install/update；注意路径合法性及 PATH 环境变量配置，且可能与 vendor-bin 类插件冲突。

什么是 bin-dir 配置项？

bin-dir 是 Composer 的全局或项目级配置项，用于指定通过 composer install 或 composer update 安装的可执行脚本（如 phpunit、laravel、drush）最终被软链接或复制到的目录。默认值是 vendor/bin，但你可以改到任意有写权限的路径，比如 bin 或 ./scripts。

如何设置 bin-dir？

有两种方式生效，优先级：项目 composer.json > 全局 config > 默认值。注意：修改后需重新运行 composer install 或 composer update 才会重建二进制文件链接。

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

  {
      "config": {
          "bin-dir": "bin"
      }
  }

• 全局级（影响所有项目）：

  composer config -g bin-dir bin

  （该命令会把 bin-dir 写入 ~/.composer/config.json）
• 临时覆盖（仅本次命令）：

  composer install --bin-dir=scripts

⚠️ 注意：bin-dir 值不能以 ../ 开头（Composer 会拒绝解析），也不能是绝对路径（除非你用 --no-plugins 强行绕过校验，不建议）。

为什么改了 bin-dir 后命令找不到？

常见原因不是配置失败，而是 shell 没有把新目录加进 $PATH。Composer 只负责把可执行文件放过去，不自动帮你导出环境变量。

GPTBots

企业级AI智能体构建平台

下载

• 确认文件已生成：ls -l bin/ 应能看到类似 phpunit -> ../vendor/phpunit/phpunit/phpunit 的符号链接
• 检查 $PATH 是否包含该目录：echo $PATH | grep bin（如果用的是 bin 目录）
• 临时加入 PATH：export PATH="./bin:$PATH"（当前终端有效）
• 永久生效（如用 bin）：在 ~/.bashrc 或 ~/.zshrc 中追加 export PATH="./bin:$PATH"，然后 source ~/.zshrc

bin-dir 和 vendor-bin 插件冲突吗？

会。如果你同时用了 dealerdirect/phpcodesniffer-composer-installer 或 roave/composer-dev-dependencies 这类依赖 vendor-bin 行为的插件，它们可能绕过 bin-dir 配置，直接往 vendor/bin 写文件。这类插件通常有自己的配置键（如 bin-dir 在插件自己的 extra 段），和 Composer 原生的 bin-dir 无关。

简单判断方式：

composer show --plugins | grep -i bin

真正要统一管理二进制路径，得逐个查插件文档，看它是否支持同名配置，或是否允许禁用其自动 bin 注册逻辑。