执行 composer install 安装依赖,确保 composer.lock 存在;2. 检查 composer.json 是否正确声明包;3. 清除缓存并重装依赖;4. 验证 PHP 环境满足平台要求。

遇到 Composer 提示“Package is not installed”时,通常是因为某个包在 composer.json 中被声明,但在 vendor 目录中实际未安装,或 composer.lock 与当前环境不一致。以下是几种常见修复方法。
检查并运行 Composer Install
最常见原因是依赖未正确安装。尝试执行以下命令:
- composer install —— 安装 composer.lock 中锁定的依赖版本。
- 如果项目是新克隆的,确保 composer.lock 文件存在且完整。
- 若没有 composer.lock 或想重新生成依赖,可使用 composer update,但需注意版本变动风险。
确认包是否在 composer.json 中正确声明
打开 composer.json 文件,检查报错的包是否在 require 或 require-dev 列表中。
- 如果缺失,手动添加并运行 composer require vendor/package-name。
- 如果已存在但仍未安装,可能是缓存或网络问题,继续下一步。
清除 Composer 缓存并重试
Composer 的本地缓存可能导致安装失败或状态错误。
- 运行 composer clear-cache 清除下载缓存。
- 删除 vendor/ 目录和 composer.lock 文件。
- 重新执行 composer install 完整安装所有依赖。
检查平台依赖(如 PHP 扩展)是否满足
某些包依赖特定 PHP 版本或扩展,若不满足,Composer 会跳过安装。
- 运行 composer check-platform-reqs 查看当前环境是否符合要求。
- 根据提示安装缺失的扩展(如 gd、mbstring、curl 等)或调整 PHP 版本。
基本上就这些。多数“Package is not installed”问题通过重新安装、清理缓存或补全依赖即可解决。关键是保持 composer.json、composer.lock 和实际环境的一致性。










