答案是依赖冲突或环境不兼容导致，需检查php版本、缺失扩展（如mbstring/xml/zip/curl）及composer.lock与composer.json一致性。运行php -m验证扩展，用php --ini定位cli配置文件，docker环境须在dockerfile中显式安装扩展，切勿仅依赖web端phpinfo结果。
Composer install 报错说“Package X not found”或“Your requirements could not be resolved”
这通常不是真缺组件，而是当前 PHP 版本、已安装扩展、或 composer.json 中的版本约束不兼容。先别急着装扩展，先看报错里具体卡在哪一行——重点盯住 ext-mbstring、ext-xml、ext-zip、ext-curl 这几类扩展名。
实操建议：
- 运行
php -m看已启用的扩展列表，确认mbstring、xml、zip是否在其中；不在就说明 PHP 编译时没带，或php.ini里被注释了 - 检查
php --ini输出的配置文件路径，打开对应php.ini，取消注释类似extension=mbstring、extension=zip这样的行（注意 Windows 下是php_zip.dll，Linux/macOS 一般是zip.so） - 改完后重启 Web 服务（如 Apache/Nginx）或 CLI 环境，再跑
php -m | grep -i zip验证 - 如果用的是 Docker，得在
Dockerfile里显式安装扩展，比如docker-php-ext-install mbstring xml zip curl
报错含 “Your lock file does not contain a compatible set of packages”
这是 composer.lock 和当前 composer.json 或 PHP 版本不匹配导致的，不是缺组件，而是依赖解析失败。尤其常见于从 PHP 7.x 升到 8.x 后，某些包已弃用旧版。
实操建议：
- 先删掉
composer.lock和vendor/目录（确保你没手动改过vendor/里的代码） - 运行
composer install --ignore-platform-reqs强制跳过平台检查（仅临时调试用，上线前必须去掉） - 更稳妥的做法：用
composer update --dry-run看哪些包会升级或冲突，再针对性调整composer.json中的版本号（比如把"monolog/monolog": "^1.0"改成"^2.0"） - 若项目锁定 PHP 版本（如
"php": "^7.4"），而本地是 PHP 8.2，就得要么降级 PHP，要么放宽约束（如改成"php": "^7.4 || ^8.0"）
报错提示 “The requested PHP extension ext-gd is missing” 但 phpinfo() 显示已加载
常见于 CLI 和 Web 使用不同 php.ini。composer install 走的是 CLI 模式，而浏览器访问走的是 Web SAPI，两者可能加载不同配置。
实操建议：
- 运行
php -i | grep "Loaded Configuration File"，确认 CLI 用的是哪个php.ini - 对比
php -m和php -i | grep gd，看 GD 是否真在 CLI 模式下启用 - Mac 用户用 Homebrew 安装 PHP 时，GD 默认不开启，需执行
brew install php@8.2-gd（版本号按实际替换） - Ubuntu/Debian 下，装完
php-gd包后仍不生效，大概率是没启用模块：运行sudo phpenmod -v 8.2 gd（版本号对齐）
用 Laravel Sail 或 Laravel Homestead 时 Composer install 失败
这类工具封装了容器环境，错误信息常被吞掉一层。报“缺组件”往往是因为容器内 PHP 镜像没预装对应扩展，或 sail up 启动后未重新构建镜像。
实操建议：
- 进容器查真实环境：
./vendor/bin/sail bash→php -m→php --version - 修改
docker-compose.yml的build部分，在Dockerfile里补扩展，例如加一行RUN docker-php-ext-install mbstring zip xml curl - 改完必须重建镜像：
./vendor/bin/sail build --no-cache，否则sail up还是旧镜像 - Homestead 用户注意：Vagrantfile 里
install块只在首次vagrant up执行，后续加扩展要手动进 box 运行sudo phpenmod -v 8.1 mbstring
最容易被忽略的点：PHP CLI 和 Web SAPI 的扩展状态完全独立，php -m 结果和浏览器里 phpinfo() 不一致是常态；Composer 只认 CLI 环境，别被网页端正常就误判为“已装好”。
