vendor目录缺失时composer install失败，是因为它依赖composer.lock严格还原依赖，但首次安装需vendor下中间文件（如installed.json）作为流程基础，而这些文件在vendor为空时不存在，故报错而非降级处理。
vendor 目录缺失时 composer install 为什么失败
因为 composer install 默认只读取项目根目录下的 composer.lock 文件，并严格按其中记录的包版本、哈希值和依赖顺序安装。如果 vendor 完全不存在，它不会自动跳过校验或降级行为——而是直接报错，例如：Package directory vendor/autoload does not exist 或更常见的 Could not find package ... in lock file（实际是路径未初始化导致后续解析失败）。本质不是“找不到包”，而是 install 流程依赖 vendor/composer/installed.json 等中间状态文件，而这些文件在首次安装前根本不存在。
必须先运行 composer install 而不是 composer update
虽然两者都能生成 vendor，但目的和行为完全不同：
-
composer install：以composer.lock为唯一权威，还原**完全一致**的依赖树，适合部署和协作环境 -
composer update：忽略lock，重新解析composer.json并拉取最新兼容版本，会修改lock文件，不适合修复丢失的vendor
如果你的 composer.lock 是可信的（比如来自 Git 主干），就该用 install；如果 lock 已损坏或丢失，则需先 composer update --lock 重建锁文件，再跑 install。
常见错误操作与对应修复命令
以下命令均在项目根目录执行，且假设 composer.json 和 composer.lock 存在且有效：
- 误删
vendor后直接composer install却提示 “Cannot create cache directory” 或卡住：先清空 Composer 缓存composer clear-cache，再重试 - 提示
file could not be downloaded: failed to open stream: Connection refused：说明某包源不可达，临时切回 Packagist 官方源composer config -g repo.packagist composer https://packagist.org - 执行后
vendor/autoload.php仍不存在：检查是否遗漏了--no-scripts参数（某些脚本会生成 autoload），去掉该参数重试 - CI/CD 中反复失败：加上
--no-interaction --prefer-dist --optimize-autoloader避免交互、加速下载、生成高效加载器
composer install --no-interaction --prefer-dist --optimize-autoloader
校验 vendor 是否真正完整
光看目录存在不等于可用。关键要验证三件事：
-
vendor/autoload.php文件可读且不为空 -
vendor/composer/installed.json存在且 JSON 格式合法（可用php -l vendor/composer/installed.json快速检查） - 运行
composer dump-autoload -o不报错，且生成的vendor/composer/autoload_classmap.php有内容
如果项目使用了插件（如 hirak/prestissimo 或自定义 installer），还要确认其配置仍在 composer.json 的 config.plugins 或全局配置中生效——否则 install 可能跳过关键步骤，表面成功实则漏装。
