composer 自动将包中 composer.json 声明的 “bin” 字段所指可执行文件软链接至 vendor/bin/ 目录，linux/macos 创建符号链接，windows 生成 .bat/.cmd 包装器，同名时保留首个并警告。
Composer 会自动把包中声明的可执行文件（bin 文件）软链接到 vendor/bin/ 目录下，前提是该包在 composer.json 中正确配置了 "bin" 字段。
bin 字段定义可执行入口
一个包若想让自己的命令被全局调用，需在它的 composer.json 里声明 "bin" 字段，值是一个字符串或字符串数组，指向项目根目录下的可执行脚本路径（通常是 php 文件）：
"bin": "bin/my-command""bin": ["bin/my-command", "bin/another-script"]
这些路径必须是相对包根目录的，且文件需有可执行权限（Linux/macOS）或带正确的 shebang（如 #!/usr/bin/env php），windows 下则依赖扩展名（如 .bat 或通过 Composer 自动生成的包装器）。
install/update 时自动生成链接
当你运行 composer install 或 composer update，Composer 会扫描所有已安装包的 composer.json，收集它们的 bin 声明，然后在 vendor/bin/ 下为每个声明创建符号链接（Linux/macOS）或生成 .bat/.cmd 包装器（Windows）：
- Linux/macos：执行
ln -sf ../foo/bar/bin/my-command vendor/bin/my-command - Windows：生成
vendor/bin/my-command.bat，内容调用 PHP 执行原脚本
链接名称默认取 bin 数组中文件的 basename（如 bin/phpunit → vendor/bin/phpunit），不带路径。
冲突时自动重命名
如果多个包声明了同名 bin 文件（比如都叫 phpunit），Composer 不会覆盖，而是保留第一个解析到的，并跳过后续同名项——但会输出警告。你可以手动在根项目的 composer.json 中用 "bin-dir" 指定其他目录，或通过 "scripts" + composer run-script 绕过命名冲突。
可执行文件本身要能独立运行
被链接的脚本必须能直接执行，常见写法：
- 开头加
#!/usr/bin/env php，并设 chmod +x（unix） - 第一行是 PHP 开标签
也可，但推荐 shebang 方式更健壮 - 脚本内应使用
__DIR__或dirname(__FILE__)定位自身位置，避免因工作目录不同导致加载失败
Composer 不修改脚本内容，只负责链接；能否跑起来，取决于脚本自身的健壮性。
基本上就这些。不是 magic，就是读配置、建链接、按规则兜底——简单但容易忽略细节。