报“your requirements could not be resolved”不是依赖冲突，而是本地php版本过低、关键扩展缺失或platform配置与实际环境不符；应运行composer check-platform-reqs定位缺失项，勿盲目删vendor或加--ignore-platform-reqs。
composer install 报错，90% 不是依赖冲突，而是环境不匹配或镜像没配对——别急着删 vendor，先看报错里带 Your requirements could not be resolved 还是 Connection refused，这两类问题的解法完全相反。
报 “Your requirements could not be resolved” 怎么办
这不是版本选不出来，是当前 PHP 环境根本达不到 composer.lock 里某包的硬性门槛。
- 运行
composer check-platform-reqs，它会直接列出缺失的 PHP 版本、扩展（如ext-mbstring、ext-xml）或 ini 配置项 - 检查
composer.json顶部是否有"config": {"platform": {...}}，比如写了"php": "8.2.10"，但你本地是 PHP 8.1 —— 这种“假装有”的配置会让composer install直接失败，而不是降级兼容 -
composer.lock里记录的包可能要求 PHP >=8.1，而你用的是 PHP 8.0；这时加--ignore-platform-reqs能过安装，但运行时大概率爆ParseError或Class not found，不是真解决 - 别信
composer diagnose的“OK”提示——它只验基础连通性，不校验 lock 文件里每个包的实际运行条件
卡在 “Loading composer repositories” 或报 “Connection refused”
说明请求根本没发出去，或者发出去后没人应答。Composer 没在下载，它甚至还没开始找包。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先跑
ping packagist.org：如果返回unknown host，就是 DNS 解析失败，不是 Composer 问题，该改系统 DNS（比如设为8.8.8.8） - 确认镜像已生效：
composer config -g repo.packagist输出必须是完整 JSON，形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；缺斜杠、少composertype、写成repos.packagist都无效 - 项目根目录若存在
"repositories": []或任何repositories字段，全局镜像会被彻底忽略——此时得进项目目录执行composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 清缓存不是可选项：
composer clear-cache必须做，否则旧失败路径还在缓存里，重试照样走原路
装完 vendor 但类找不到、命令报错
composer install 成功 ≠ 项目能跑起来。autoload 没生效、路径映射错位，才是后续问题的主因。
- 检查
vendor/autoload.php是否存在且可读；如果file_put_contents(/path/to/vendor/autoload.php): Permission denied，大概率是vendor/目录被sudo创建过，属主是 root，而你用普通用户运行命令——用sudo chown -R $USER:$USER vendor/修复，别乱chmod 777 - 运行
php -d display_errors=1 -d error_reporting=-1 vendor/autoload.php，看是否直接 fatal；如果是，说明 autoload 文件本身生成失败，常见于 PHP 版本或扩展缺失 -
composer dump-autoload可强制重生成映射，但前提是composer.json里的autoload段写对了路径，比如"psr-4": {"App\": "app/"}中的app/目录必须真实存在 - 别忽略
composer.lock的时间戳——它记录的是某次composer update时的精确状态；如果团队有人手动改过composer.json却没 commit lock，其他人install就会和预期不一致
CI/CD 或新同事 clone 后 install 失败
不是网络慢，是交付物不完整。这类失败往往发生在“看起来一切正常”的时候。
- 确认
composer.lock已提交到 Git——如果它被.gitignore错误排除，composer install会 fallback 到update行为，结果不可控 - 检查
vendor/是否被.gitignore误加，导致 CI 拉不到完整代码树（尤其 Docker 构建时） -
composer.json里包名末尾多一个空格（如"laravel/framework": "10.x-dev "）不会在 install 阶段报错，但后续php artisan会提示Class not found，很难定位 - CI 脚本里只允许出现这一行：
composer install --no-dev --optimize-autoloader；加--ignore-platform-reqs或混入composer update，等于放弃版本控制权
最常被忽略的一点：报错信息里带路径的那一行，就是线索。比如 file_put_contents(/var/www/project/vendor/autoload.php) 权限拒绝，问题就在 vendor/ 目录归属；PHP version 8.0.30 does not satisfy...，就该去调 PHP 版本，而不是换镜像。
