vendor目录是Composer硬编码的默认依赖安装路径,不可更改;autoload.php是自动加载唯一入口,必须在启动时引入;vendor/bin下为包注册的本地可执行文件;vendor不提交Git,生产环境应使用--no-dev安装。

vendor 目录是 Composer 安装依赖的默认落点
它不是配置出来的“可选位置”,而是 Composer 在当前项目根目录下硬编码写死的默认安装路径。只要运行 composer install 或 composer require,依赖包就会解压、重命名、链接到 vendor/ 下——没得商量,也不建议改。
- 改
vendor-dir配置(如设为libs)虽可行,但会破坏 IDE 自动索引、PHPStan/ Psalm 的默认扫描路径,以及大多数 CI 脚本的预期 -
vendor/本身不进 Git,靠composer.lock锁定版本;删了它再composer install就能重建,这是设计使然,不是缺陷 - 别手动往
vendor/里丢文件或改包内代码——下次composer update会直接覆盖
autoload.php 是自动加载机制的唯一入口
所有通过 Composer 安装的包,其类能否被 new 或 use,全靠 vendor/autoload.php 这个文件驱动。它不是“辅助脚本”,而是 PSR-4 / PSR-0 / ClassMap 加载规则的运行时编译结果。
- 必须在项目启动时
require它一次,否则即使包已下载,Class 'GuzzleHttp\Client' not found这类错误照出 - 不要用
include_once 'vendor/autoload.php'多次——Composer 的 autoloader 是单例,重复引入无意义,还可能触发 warning - 如果用的是 Laravel、Symfony 等框架,它们已封装好 autoload 引入逻辑;纯脚本项目则需自己加这行:
require __DIR__ . '/vendor/autoload.php';
vendor/bin 下的可执行文件由包的 bin 字段注册
像 phpunit、laravel、phinx 这些命令,不是全局安装的,而是每个项目独立拥有的——它们实际是 vendor/bin/ 下的符号链接或代理脚本,指向对应包里的真正二进制文件。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 执行
./vendor/bin/phpunit和全局phpunit可能版本不同,优先走项目本地的,这是预期行为 - 某些包(如
phpstan)会在安装时检查vendor/bin/是否在$PATH中,不在就提醒你加;但不加也没关系,直接用完整路径调用即可 - 如果
vendor/bin里没看到某工具,说明该包的composer.json没声明"bin"字段,哪怕它有可执行文件也进不来这里
vendor 目录体积大?别急着删,先看哪些真能动
vendor/ 动辄百 MB,但不是所有内容都可安全清理。盲目 rm -rf vendor && composer install 是最省事的方案,但有些场景下可以更精细:
-
vendor/composer/installed.json和vendor/composer/autoload_*.php是 Composer 自己生成的元数据,删了会导致自动加载失效,不能单独删 -
vendor/{package}/.git或vendor/{package}/tests/通常可删——前提是包没声明"autoload-dev"且你不用它的测试工具 - 想彻底瘦身?用
composer install --no-dev跳过 require-dev 里的包,生产环境部署必须这么干
真正容易被忽略的是:很多团队把 vendor/ 提交进 Git,或者用 git add vendor 应对“CI 上装太慢”的问题——这会让协作和审计失控,比多等两分钟更难收场。

















