Composer报错应优先分析错误关键词：平台要求问题用why-not定位冲突包，网络问题换阿里云镜像并清缓存，权限问题禁用sudo并修复属主，包找不到则核对大小写和镜像同步状态。
Composer install 报错不是环境坏了，而是错误信息里藏着明确线索——直接看报错关键词，比重装、换 PHP、删 lock 文件有效十倍。
报错 Your requirements could not be resolved 怎么定位拦路包
这说明 composer.json 里写的约束互相打架，不是网络或权限问题。最常发生在 Laravel 升级后没同步配套包，或某个老旧 bundle（比如 jms/security-extra-bundle）锁死了 Symfony 2.x 或 PHP 5.6。
- 别删
composer.lock——它记录的是已验证可行的版本组合，删了反而让问题更难复现 - 运行
composer why-not php:8.3（把8.3换成你实际想用的版本），直接看到哪个包在拒绝升级 - 若确认是 PHP 版本不匹配（如提示
php >=7.4.0，但你本地是 8.2），可临时绕过：composer install --ignore-platform-reqs；但注意：这也会跳过ext-pcntl、ext-redis等扩展检查，得自己心里有数
卡在 Loading composer repositories 或 Connection timed out 怎么破
国内直连 packagist.org 基本不可靠，DNS 解析慢、TLS 握手失败、连接中断都是常态。这不是你本地 PHP 或 Composer 出了问题。
- 换阿里云镜像（全局生效）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 清缓存（换源后必做）：
composer clear-cache - 企业网或弱网环境下，延长超时：
composer config -g process-timeout 3000和composer config -g http-timeout 600 - 某些防火墙会拦截 SNI 请求，可临时关 TLS 验证：
composer config -g secure-http false，但生产环境禁用
Permission denied: failed to create directory vendor/ 怎么修
根本原因是当前用户对目标路径无写权限，90% 源于误用 sudo composer install，导致 vendor/ 下文件属主变成 root，后续再运行就卡住。
- 绝对不要用
sudo composer install——这是绝大多数权限问题的起点 - 检查归属：
ls -ld vendor ~/.composer/cache；若属主是root，修复：sudo chown -R $USER:$USER vendor ~/.composer/cache - WSL 用户特别注意：
/mnt/c/下项目无法正确处理 Linux 权限，唯一稳解是把项目移到 WSL 原生路径（如~/projects/myapp） - 缓存目录也可主动换到用户可控位置：
composer config -g cache-dir ~/composer-cache，之后删掉旧缓存更安全
Could not find package 或 The requested package could not be found 怎么查
包名拼错、未注册到 Packagist、镜像源不同步，都会触发这个错误。它和依赖冲突无关，纯属“找不到东西”。
- 包名严格区分大小写，且必须含 vendor 前缀（如
phpunit/phpunit，不能只写phpunit） - 打开
https://packagist.org/packages/vendor/package（替换为实际值），看是否返回 404 - 检查是否禁用了官方源：
composer config -g repos.packagist，若输出不是https://packagist.org或对应镜像地址，需手动恢复：composer config -g repo.packagist.org '{"type":"composer","url":"https://packagist.org"}' - 国内镜像可能滞后，新发布的包在阿里云镜像里还没同步，可临时切回官方源验证：
composer install --repository=https://packagist.org
真正麻烦的从来不是报错本身，而是忽略错误信息里的具体路径、版本号、扩展名这些字段，转头去改 PHP 配置或重装 Composer。每个错误关键词都对应一个确定环节：平台要求、网络链路、文件系统、包索引——盯住它，就不用猜。
