Composer的 vendor/bin 目录是用来做什么的？ (命令行工具)

vendor/bin 目录由 composer 自动创建，用于存放依赖包通过 composer.json 中 “bin” 字段声明的可执行脚本链接或副本；仅声明了 “bin” 且指向有效脚本时才会被暴露，同名会覆盖，实际调用仍依赖原路径和 autoload。

vendor/bin 是 Composer 自动创建的符号链接（或可执行文件）存放目录，专门用于暴露依赖包中提供的命令行工具，让开发者能在项目根目录下直接运行它们，而无需记住完整路径或手动添加到 $PATH。

为什么有些包的命令会出现在 vendor/bin 里？

只有在包的 composer.json 中声明了 "bin" 字段，且该字段指向一个可执行脚本（如 phpstan、phpcs、laravel-zero 的入口文件），Composer 安装时才会把对应文件软链（linux/macOS）或复制（windows）进 vendor/bin。

• 例如 phpunit/phpunit 的 composer.json 包含 "bin": ["phpunit"]，安装后 vendor/bin/phpunit 就可用
• 如果包没写 "bin"，哪怕它有 bin/ 目录或可执行脚本，也不会自动暴露到 vendor/bin
• 多个包声明同名 "bin"（如都叫 foo），后安装的会覆盖先安装的 —— Composer 不做冲突检测

运行时实际调用的是什么？

你执行 vendor/bin/phpcs，真正运行的通常是 vendor/squizlabs/php_codesniffer/bin/phpcs 这类原始路径。Composer 只是做了路径映射，不改写脚本内容或逻辑。

• 脚本本身仍依赖其所在包的 autoload 和相对路径（比如它可能 require ../src/...）
• 因此不能把 vendor/bin/phpcs 单独拷出去用，它不是独立二进制
• windows 下生成的是批处理文件（.bat），内容只是包装了 php "xxxphpcs" 调用

常见问题和绕过方式

有时 vendor/bin 里的命令报错，比如 class not found 或 command not found，大概率不是路径问题，而是环境或加载逻辑不对。

• ./vendor/bin/phpunit 报 Class 'PHPUnitFrameworkTestCase' not found：说明脚本没走 Composer 自动加载，检查该脚本是否漏了 require __DIR__ . '/../vendor/autoload.php';
• bash: vendor/bin/phpcs: Permission denied（Linux/macOS）：文件缺少可执行权限，运行 chmod +x vendor/bin/phpcs
• 想全局使用（不用写 vendor/bin/ 前缀）：可以把 vendor/bin 加进 shell 的 $PATH，但注意这会让所有项目共享同一套命令版本，容易引发冲突

// 示例：一个典型的 bin 脚本头部（如 phpunit） #!/usr/bin/env php