Composer 通过 config.bin-dir 指定可执行脚本安装目录，如 "bin"；依赖包的 bin 文件及自定义工具（需在 composer.json 的 bin 字段声明）均会部署至此；配置 PATH 后可全局调用。
Composer 本身不提供直接配置 bin 目录路径的字段，但你可以通过 bin-dir 配置项来指定项目中可执行脚本（即命令行工具）安装到的目录。
设置 bin-dir 指向自定义 bin 目录
在 composer.json 的 config 段中添加 bin-dir 字段，值为相对路径（相对于项目根目录）：
{
"config": {
"bin-dir": "bin"
}
}
执行 composer install 或 composer update 后，所有依赖包中声明的二进制文件（如 phpunit、laravel 等）都会被软链接或复制到 ./bin/ 目录下。
让自己的命令行工具被 Composer 自动识别
如果你正在开发一个命令行工具（比如 mytool），需在 composer.json 中声明 bin 字段，指向你的可执行脚本：
{
"bin": ["bin/mytool"],
"config": {
"bin-dir": "bin"
}
}
-
bin/mytool必须是可执行文件（Linux/macOS 下有x权限；Windows 下可为.bat或.php文件） - 文件开头建议加上 shebang（如
#!/usr/bin/env php），确保能被直接运行 - 该脚本通常 require 项目 autoload 并调用主逻辑类
确保命令可全局调用（可选但推荐）
把 ./bin 加入系统 $PATH，就能在项目任意子目录下直接运行你的命令：
- Linux/macOS：在
~/.bashrc或~/.zshrc中添加export PATH="./bin:$PATH"（注意：此写法仅在当前目录生效；更稳妥的是用绝对路径或 alias） - 开发时常用方式：在项目根目录运行
export PATH=$(pwd)/bin:$PATH - CI/CD 或部署时，可将
bin目录加入环境变量或使用全路径调用
验证是否生效
运行以下命令检查：
-
composer config bin-dir—— 查看当前配置的 bin 目录 -
ls -l bin/—— 确认你的脚本是否已出现在该目录 -
bin/mytool --version—— 直接执行测试 -
which mytool（若已配置 PATH）—— 看是否能被 shell 找到
