直接换阿里云镜像源并执行composer clear-cache可解决90%依赖拉取慢问题；卡在Downloading是因直连packagist.org导致DNS/TLS超时，非网络带宽问题，必须严格配置repo.packagist、type为composer、URL带尾部/且用sudo -u指定用户（如宝塔www）确保生效。
直接换阿里云镜像源并执行 composer clear-cache，能解决 90% 的 PHP 依赖拉取缓慢问题；不换源，其他优化基本无效。
为什么 composer install 卡在 “Downloading…”？
不是你网络差，是 Composer 默认直连 https://packagist.org —— 物理距离远、TLS 握手慢、防火墙干扰共同导致连接卡顿或超时。哪怕你带宽 1Gbps，也救不了 DNS 解析失败或单次 TLS 超时重试。
- 现象：日志停在
Downloading https://packagist.org/p/monolog/monolog.json或反复出现connect timeout - 验证方法：运行
composer install -vvv，最后一行若含https://packagist.org，说明镜像根本没生效 - 常见误配：
repos.packagist（多一个 s）、漏掉composer类型参数、URL 缺末尾/（如写成https://mirrors.aliyun.com/composer❌）
composer config -g repo.packagist 怎么写才真正生效？
这条命令必须严格按三要素拼写，缺一不可，否则静默失败（不报错，但配置无效）：
- 字段名必须是
repo.packagist（不是repos.packagist，也不是packagist） - 第二个参数必须是
composer（声明仓库类型，漏掉就 fallback 到官方源） - URL 必须以
https://开头，且结尾带/：https://mirrors.aliyun.com/composer/✅
正确命令：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
立即学习“PHP免费学习笔记（深入）”；
验证是否写入成功：composer config -g repo.packagist
输出应为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 或仅 https://mirrors.aliyun.com/composer/（新版 Composer 行为）。
宝塔面板里换源后还是慢？查执行用户权限
宝塔的「PHP 管理器」或「一键部署」通常以 www 用户身份运行，而 composer config -g 默认写的是当前登录用户（比如 root）的 ~/.composer/config.json，www 根本读不到。
- 查实际执行用户：在宝塔【终端】中执行
sudo -u www composer config -g repo.packagist - 若返回空或
https://packagist.org，需用该用户重配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本或 systemd 服务同理——别依赖全局配置，临时加
--repository更可靠
换源后仍慢？清缓存和关 Xdebug 是关键
镜像配置对了，但 composer install 还卡，大概率是旧缓存或调试扩展拖慢：
-
composer clear-cache必须执行：缓存里存着旧的packages.json元数据，Composer 会优先读它，并尝试从旧地址拉取校验信息 - Xdebug 会拖慢依赖解析阶段（
Resolving dependencies）3–10 倍：用php -d xdebug.mode=off $(which composer) install临时禁用 - 并发下载没提速？确认 Composer 版本 ≥ 2.2，并设
composer config -g parallel-downloads 10；但前提是镜像支持 HTTP/2，否则并发请求会被排队堵死
最常被忽略的细节：镜像 URL 写对了、-g 加对了、clear-cache 执行了、Xdebug 关了——这四步做完，再跑 composer install -vvv，看到 Reading packages.json from cache at .../https---mirrors-aliyun-com-composer/ 就算真正跑通了。
