composer报“package is not installed”的直接原因是vendor目录缺失或composer.lock与vendor不一致，因其严格校验锁文件版本、哈希值与vendor实际结构。
直接原因：当前项目没有 vendor 目录，或 composer.lock 与 vendor/ 不一致，导致 Composer 认为“包未安装”——哪怕你刚执行过 composer install。
为什么 composer show 报 “Package is not installed”
这不是网络或权限问题，而是 Composer 的本地状态校验机制在起作用。它不只看 composer.json，而是严格比对：composer.lock 中记录的包版本、哈希值，和 vendor/ 下实际存在的目录结构与文件完整性。
-
vendor/被手动删过（比如误用rm -rf vendor），但没重新install -
composer.lock是旧的，而你只运行了composer require xxx但没成功写入（例如因网络中断、权限拒绝） - 你在子目录下执行了
composer show，但当前工作目录不是项目根（即不含composer.json） - 使用了
--no-install或--no-autoloader等标志安装，导致vendor/autoload.php或包目录未生成
composer install 后仍报错？先检查这三件事
别急着重装，先确认基础状态是否可信：
- 运行
ls -la，确认当前目录下存在composer.json和composer.lock - 运行
ls -la vendor/，看是否有对应包的目录（如vendor/monolog/monolog），而不是空目录或只有autoload.php - 运行
composer diagnose，重点看输出中 “The lock file is not up to date with the latest changes in composer.json” 或 “Vendor dir does not exist” 这类提示
修复命令组合（按优先级顺序试）
多数情况只需其中一步，但顺序很重要：从轻量校验到强制重建。
- 先尝试同步锁文件与 vendor：
composer install --no-dev（跳过 dev 包可减少干扰） - 若失败，清掉残留再重装：
rm -rf vendor composer.lock && composer install（⚠️确保composer.json是你想要的版本） - 仍不行？强制忽略 lock 文件重建：
composer update --lock（仅更新 lock 文件内容，不改 vendor）→ 再跟composer install - 极少数情况是 Composer 自身损坏，可重装二进制：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" && php composer-setup.php --filename=composer --install-dir=/usr/local/bin
CI/CD 或 Docker 环境里特别容易踩的坑
这类环境常禁用交互、缓存或挂载方式异常，导致 vendor 看似存在实则不可读：
- Docker 中挂载了空 host 目录到
/app/vendor，覆盖了镜像内已安装的包 - CI 使用缓存但只缓存
vendor/，没缓存composer.lock，导致两者脱节 - Git 仓库忽略了
vendor/，但 CI 脚本错误地从上一次构建复制了旧vendor，而非重新install - 使用
composer install --prefer-dist --no-interaction --optimize-autoloader时，若网络拉取失败，Composer 默认静默跳过而非报错，结果vendor缺包却不提醒
composer install --prefer-dist --no-interaction --optimize-autoloader || (echo "Install failed, checking lock..." && ls -l composer.lock && exit 1)
真正麻烦的不是命令记不住，而是错误被吞掉、状态被缓存、或者你以为 vendor 存在其实只是个空文件夹——查的时候多看一眼 ls -la vendor/xxx，比反复 update 有用得多。
