卡在Resolving dependencies是SAT求解器暴力回溯导致的本地计算瓶颈，与网络无关；卡在Downloading则是镜像配置失效（如URL缺斜杠、type缺失）所致，需分别通过关闭Xdebug、放开内存限制或重配镜像解决。
ThinkPHP项目执行composer update命令卡死在Resolving dependencies或Downloading阶段，不是网络慢导致的假象，而是依赖解析器陷入无限回溯或内存耗尽——此时强行等待只会浪费时间，必须针对性干预。
先确认卡死类型再动手
按下Ctrl+C中断当前命令，观察终端最后一行输出：
如果停在Resolving dependencies：说明Composer正在反复尝试满足版本约束，和镜像源无关，是PHP内存或Xdebug导致的逻辑卡顿。
如果停在Downloading：大概率是镜像配置失效或URL少斜杠，不是网速问题。
立即学习“PHP免费学习笔记（深入）”；
执行composer config -g repo.packagist，输出必须是完整URL或JSON对象；若为空、null或显示https://packagist.org，说明镜像根本没生效。
解决Resolving dependencies卡死
第一步：临时关闭Xdebug
开启Xdebug会让依赖解析慢5–10倍，直接导致卡死。运行：php -d xdebug.mode=off $(which composer) update
第二步：释放内存限制
Composer默认受PHP memory_limit约束。执行：COMPOSER_MEMORY_LIMIT=-1 composer update
第三步：跳过平台检查（仅临时验证）
若PHP版本与目标TP版本不匹配（如用PHP 7.4升级TP8），解析器会反复试错。加--ignore-platform-reqs绕过校验：COMPOSER_MEMORY_LIMIT=-1 php -d xdebug.mode=off $(which composer) update --ignore-platform-reqs
【注意】此参数仅用于快速验证是否环境阻塞，生产环境严禁保留
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
解决Downloading卡死
方法一：强制重写全局镜像
执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，注意中间必须有composer这个type，URL末尾必须带/。
方法二：改用项目级镜像（更可靠）
进入项目根目录（含composer.json），执行composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），该命令会自动写入composer.json的repositories字段。
方法三：临时指定镜像安装
直接在update命令后追加--repository=https://mirrors.aliyun.com/composer/，例如：composer update topthink/framework --repository=https://mirrors.aliyun.com/composer/
卡死后必须清理的三样东西
① 删除vendor/文件夹
② 删除composer.lock文件
③ 执行composer clear-cache
这三步缺一不可。旧composer.lock记录的是packagist.org的包哈希，和国内镜像源不兼容；残留vendor会干扰新依赖加载路径；缓存损坏会导致元数据解析失败。
升级前锁定版本再重装
第一步：编辑composer.json，把"topthink/framework"的值改为明确版本号，例如"^8.0.5"，不要用*或dev-main。
第二步：删掉vendor和composer.lock，执行composer install --no-dev。
第三步：立即运行composer dump-autoload -o，否则php think命令和自动加载全部失效。
