直接用 composer require vendor/package-name 恢复缺失依赖,它会强制写入 composer.json、校验约束、更新 lock 并确保 autoload 生效;而 composer install 仅按 lock 还原,不识别代码实际需求,无法解决因手动删包或 lock 过期导致的类加载失败问题。

直接用 composer require vendor/package-name 就能恢复,前提是包名正确、版本兼容、且没被其他依赖锁死——它不是“重装”,而是让 Composer 重新识别并拉取缺失的依赖。
为什么不能用 composer install 恢复?
composer install 只按 composer.lock 里记录的哈希和路径还原 vendor,它不检查你代码里 use 了什么、也不管类是否真能加载。如果你手动删了 vendor/some/package,但 composer.lock 还记着它,install 会照常下载,看似恢复;但一旦你之前删过 composer.lock 或它已过期,install 就可能跳过该包,甚至装错版本。
而 require 会强制写入 composer.json(如果还没写)、触发依赖解析、校验 PHP 版本和约束,并更新 lock 文件——这才是真正“确认要它”的动作。
- 误删后只跑
composer install,composer show vendor/package-name仍可能报 “Package not found” - 运行
ls -la vendor/vendor-name/能立刻验证是否真在目录里 - 若
composer.json的require区块里压根没这行,install根本不会理它
composer require 恢复失败的三个硬性卡点
常见现象是命令执行成功,但类还是 Class not found——问题不在安装,而在后续链路断了。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
Package not found:包名拼错(比如把topthink/think-captcha写成think/captcha),或当前源没同步(私有包没配repositories) - 装上了但类不加载:检查
vendor/composer/autoload_psr4.php里有没有你的命名空间映射;PSR-4 前缀末尾漏反斜杠("think\captcha\": "src/"✅,"think\captcha": "src/"❌) - 服务提供者没注册:ThinkPHP/Laravel 扩展装完不自动生效,得确认
config/app.php的providers数组里有对应类,且没被"dont-discover": ["*"]全局屏蔽
恢复后必须人工扫的三处残留
composer remove 和 require 都只管依赖声明和 autoload,不管你的代码怎么用它。
-
use语句还在,但命名空间路径变了(比如从App\Services\Xxx改成Vendor\Xxx) - 配置文件没回滚(如
config/queue.php被扩展生成后又被你删过,恢复包不会自动补) - Laravel 的
Facade或 ThinkPHP 的alias在config/app.php里还挂着旧引用,但类文件路径已失效
最易忽略的是 OPCache —— 即使 vendor/autoload.php 修改时间最新,PHP 也可能缓存了旧的类映射。线上环境恢复后,必须清 OPCache 或重启 PHP-FPM,不能只刷页面。










