PHP文件报类找不到，90%因vendor/autoload.php未被正确引入或vendor目录缺失/不完整；需确认入口文件首行require路径正确、vendor存在且完整、composer install已成功执行。
直接说结论：PHP 文件打不开报 Composer 依赖缺失，90% 不是 PHP 文件本身问题，而是 vendor/autoload.php 没被正确引入，或 vendor/ 目录根本不存在/不完整。
为什么打开 PHP 文件就报类找不到？
常见现象是浏览器访问 index.php 时抛出 Fatal error: Class 'XXX' not found 或 require(): failed to open stream: No such file or directory in vendor/autoload.php。这不是 PHP 解析器故障，而是自动加载链断了——Composer 安装的包没生效，或入口文件压根没加载自动加载器。
- 入口文件（如
public/index.php）里漏了require __DIR__.'/../vendor/autoload.php'; - 当前工作目录不是项目根目录（即不含
composer.json的那层），导致相对路径失效 -
vendor/目录被手动删过、复制过，或composer install没跑完就中断了 - 用了
--no-scripts安装，跳过了自动生成 autoload 映射的脚本
怎么快速验证 vendor 是否真缺失？
别猜，直接看物理文件：
- 进项目根目录，执行
ls -la vendor/（Linux/macOS）或dir vendor（Windows）——如果提示 “No such file or directory”，就是没装 - 如果
vendor/存在，但里面只有composer/目录，没有monolog/、symfony/等依赖包，说明composer install被中断或失败 - 检查
vendor/autoload.php是否存在且可读：ls -l vendor/autoload.php；若文件为空或权限为 000，需重装
补装依赖前必须确认的三件事
否则重装也白搭：
立即学习“PHP免费学习笔记（深入）”；
- 当前终端所在路径必须是项目根目录（含
composer.json和composer.lock） - 运行
composer validate确认composer.lock有效；若报错 JSON 格式错误，先删掉它再重装 - 确保
php -v输出的版本和项目要求一致，且php -m | grep mbstring等基础扩展已启用（否则composer install自身就会卡住）
补装命令和关键参数
用对命令才能精准恢复，不是所有场景都该用 composer update：
- 仅缺
vendor/目录？直接跑composer install——它会严格按composer.lock重建，最快最稳 - 想跳过开发依赖（如 PHPUnit、PHPStan）？加
--no-dev：composer install --no-dev -
composer.lock损坏或丢失？删掉它，再跑composer install，Composer 会按composer.json重新生成锁文件 - 只少了一个包（比如
vendor/psr/log被误删）？删干净那个目录，再跑composer install，它只补这一个，不动其余
最容易被忽略的是：补装后，入口文件里的 require 路径是否还对。比如你在 app/Http/Controller.php 里写了 require '../vendor/autoload.php'，但实际项目结构是 app/ 在 src/ 下，路径就错了——autoload.php 必须被入口文件（通常是 public/index.php）一次性引入，其他任何地方都不能重复 require。
