composer如何设置bin目录_composer bin-dir配置说明【执行】

composer bin-dir 是 composer 安装可执行包（如 phpunit、pest）时指定二进制文件存放路径的项目级配置项，默认为 vendor/bin；修改后旧包不迁移、新包写入新路径，需同步更新 ci、ide、path 等所有依赖该路径的配置。

composer bin-dir 是什么，为什么不能直接改 vendor/bin

它不是“把命令软链接到哪”，而是 Composer 安装可执行包（比如 phpunit、larastan、pest）时，决定把这些二进制文件放在哪的配置项。默认是 vendor/bin，但你改了 bin-dir，Composer 就不会再往 vendor/bin 写，也不会自动帮你迁移旧命令。

• 改完不重装包，旧 bin 文件还在原处，新包却跑到新目录——结果是命令“一半失效”
• 很多 CI 脚本或 IDE 配置硬编码了 vendor/bin/phpunit，换目录后直接报 command not found
• bin-dir 是项目级配置，对全局 require 的包无效（比如 composer global require laravel/installer）

怎么安全地设置 bin-dir：命令行 vs composer.json

两种方式效果一致，但触发时机和适用场景不同。别混用，否则容易冲突。

• 临时改当前项目：运行 composer config bin-dir bin（注意路径是相对 project root 的）
• 想让团队/CI 一致：直接编辑 composer.json，加字段 "config": { "bin-dir": "tools" }
• 绝对路径不推荐——composer config bin-dir /usr/local/bin 看似方便，但会绕过 Composer 的权限管理，且 composer install 可能因权限失败
• 设为 bin 后，记得把 ./bin 加进 $PATH，否则 shell 找不到命令

执行 composer install 后 bin 文件没出现？检查这三点

不是配置没生效，而是依赖包本身没声明 bin 字段，或者没触发安装逻辑。

• 确认包的 composer.json 里有 "bin" 键，例如 "bin": ["phpunit"]；纯库（如 symfony/console）不带 bin，不会生成可执行文件
• 运行 composer show --all，看目标包是否在列表中且版本已锁定；如果只是 require-dev 但当前环境是 --no-dev，bin 文件也不会装
• 删掉 vendor/ 和 composer.lock 重试——有时 lock 文件残留旧 bin 路径缓存，导致跳过写入

windows 下 bin-dir 的坑：.bat 和 .php 文件共存

Composer 在 Windows 上会为每个 bin 脚本生成两个文件：phpunit（无后缀，unix 风格）和 phpunit.bat。Shell 默认优先执行 .bat，但内容只是调用 PHP 解释器跑同名 .php 文件。

• 如果你手动把 bin-dir 设成 scripts，得确保 scripts/ 在 %PATH% 里，且顺序靠前；否则可能误调系统 PATH 里的旧版 phpunit
• 某些杀毒软件会拦截自动生成的 .bat，报“可疑脚本”，需加白名单
• 不要手动删 .bat 只留 .php——Composer 下次 install 会重建，还可能覆盖你的修改

真正麻烦的不是设路径，而是所有依赖工具、CI 脚本、队友本地环境、IDE 的外部工具配置，都得同步更新。一个 bin-dir 改动，本质是在改整个项目的命令契约。