这是 composer.lock 与 composer.json 不一致导致的包缺失问题：lock 文件未记录 composer.json 中声明的包，故 install 跳过安装；需用 composer show、validate 和手动查 lock 文件确认，再通过 composer update vendor/package-name --with-dependencies 修复并提交 lock 文件。
直接结论：这不是包没下载，而是 vendor/ 目录里确实没这个包——根本原因是 composer.lock 和 composer.json 不一致，或安装过程被中断。
为什么 composer install 会跳过某个包
Composer 不是“按 composer.json 装”，而是“严格按 composer.lock 还原”。如果 lock 文件里压根没记录某个包（哪怕它明明白白写在 composer.json 的 require 里），composer install 就不会装它。
-
composer.lock被手动删了，或没提交进 Git —— 此时composer install会退化成composer update，行为不可控 -
composer.json刚加了新包，但没运行composer update或composer require，导致 lock 文件未更新 - 执行
composer install时中途 Ctrl+C、磁盘满、权限拒绝，导致vendor/写了一半就停了
快速确认是否真缺失，而不是 autoload 失效
别急着删 vendor/ 重来。先用这几个命令交叉验证：
- 运行
composer show vendor/package-name—— 如果返回 “no such package”，说明它根本没进依赖图，不是路径或自动加载问题 - 运行
composer validate --strict—— 它会明确报错：Required package "vendor/package-name" is not present in the lock file - 打开
composer.lock，搜索包名 —— 看它是否出现在packages或packages-dev数组里
修复步骤：只更新 lock，不重算依赖
目标是让 lock 文件补上缺失的包，同时不破坏已有版本约束。优先走安全路径：
- 确认
composer.json中该包写法正确：无多余空格、引号闭合、版本号格式合法（比如"laravel/framework": "^10.0"，不是"10.x-dev "） - 运行
composer update vendor/package-name --with-dependencies—— 只更新这个包及其直系依赖，避免全量重解析 - 如果该包是 dev-only 依赖，确保加了
--dev参数；如果它是被其他包间接引入的，先用composer why-not vendor/package-name查冲突点 - 成功后立刻
git add composer.lock && git commit -m "fix: add missing vendor/package-name to lock"
最容易被忽略的细节
很多人修完以为完事了，结果上线还是报 Class not found。真正卡点往往在：composer.json 里写了包，composer.lock 也补上了，但 vendor/autoload.php 没生效——因为项目入口没重新 require 它，或者用了自定义 autoloader 但没跑 composer dump-autoload。别跳过这一步。
