bin-dir 配置需在项目根目录执行才生效，全局设置不影响项目行为；应清空 vendor 后重装依赖，并确保路径无空格、用正斜杠；ide 和终端需手动刷新路径缓存。
composer config bin-dir 设不生效？先确认是否在项目级执行
很多人改了 bin-dir 却发现新安装的包二进制文件还是扔进 vendor/bin，根本原因是：这个配置默认只对当前项目生效，且必须在项目根目录下运行命令。全局设置（composer global config）不影响项目内安装行为。
- 想改当前项目的 bin 目录，进项目根目录后运行：
composer config bin-dir ./scripts - 改完立刻生效，下次
composer install或composer require就会把可执行文件放进./scripts - 如果在非项目目录下执行该命令，它会写进全局配置，但项目内仍优先读取
composer.json中的config.bin-dir字段或默认值 - 检查是否生效：运行
composer config bin-dir（确保在项目内），输出应是你设的路径，不是空或默认值
vendor/bin 被硬编码？某些包无视 bin-dir 怎么办
不是所有包都尊重 bin-dir。比如 phpunit/phpunit 的 phpunit 二进制是通过 bin 字段在 composer.json 里声明的，这类文件一定生成在 bin-dir 指向的位置；但像 laravel/installer 这种靠 post-install-cmd 脚本复制的，可能绕过配置直接写死路径。
- 验证方式：删掉
vendor/bin，执行composer install，看新生成的二进制在哪 - 真正“不遵守”的情况极少，更多是误以为没生效——比如你设了
bin-dir，但之前已有vendor/bin目录且里面有旧文件，新安装不会自动清理旧位置 - 稳妥做法：清空
vendor和旧bin目录再重装，避免残留干扰判断
windows 下路径斜杠和空格引发的权限错误
在 Windows 上设 bin-dir 为带空格路径（如 ./my tools/bin）或反斜杠路径（.bin），会导致后续执行二进制时报错：Unable to init server: Could not connect: Connection refused 或更常见的 bash: ./my: No such file or Directory ——本质是 shell 解析失败。
- 始终用正斜杠、无空格路径：推荐
./bin、../scripts，避免./my bin或.bin - 路径不要以
~或环境变量开头（如$HOME/bin），Composer 不展开它们 - git Bash 或 WSL 下尤其敏感，哪怕路径存在，斜杠方向不对也会让生成的 shell wrapper 脚本第一行
#!/usr/bin/env sh后续路径解析失败
bin-dir 改了，但 IDE 或终端找不到命令
改完 bin-dir 后，VS Code 的 PHP Intelephense、终端里的自动补全、甚至 which phpunit 都可能还指向旧路径，这不是 Composer 的问题，而是环境没刷新。
- 终端需要重新加载
$PATH：如果你把新bin-dir加进了$PATH（比如export PATH="./scripts:$PATH"），改完记得source ~/.zshrc或新开终端 - IDE 缓存未更新：phpstorm 要重新“Reload project”，VS Code 建议重启窗口或手动触发 “Developer: Reload Window”
-
composer dump-autoload不影响 bin 目录，别白忙活；真正要的是重装依赖：composer install --no-dev && composer install --dev（确保 dev-bin 也更新）
实际用的时候，最常卡住的不是配置本身，而是路径缓存、IDE 状态、以及误把全局配置当项目配置来调。改完一定要在项目目录下 composer config bin-dir 看一眼，再删 vendor 重装一次。