“卡在resolving dependencies”阶段换镜像完全无效，因其是本地sat求解器暴力回溯版本约束的过程，不发网络请求；仅当卡在downloading packages或loading metadata时，镜像才生效。
composer 中文镜像对大型项目**只加速下载，不加速解析**——这是最关键的判断。你看到的“卡在 Resolving dependencies”阶段，换任何镜像都毫无作用；只有卡在 “Downloading packages” 或 “Loading metadata” 时，镜像才真正生效。
为什么 Resolving dependencies 阶段换镜像完全无效
这个阶段是本地 SAT 求解器穷举 PHP 版本 + 包版本组合的过程，不发任何网络请求，也不读 repo.packagist 配置。它只依赖：composer.json 的约束、composer.lock 的快照、本地缓存和 CPU 算力。
- 宽泛的 PHP 版本约束（如
"php": "^7.4 || ^8.0 || ^8.1 || ^8.2"）会让求解器尝试数百种组合 -
"minimum-stability": "dev"强制拉取所有dev-分支，候选版本数指数级膨胀 -
composer.lock被删或未提交，install实际退化为全量update，触发完整解析 - Xdebug 启用状态下，SAT 求解器性能下降 3–5 倍
镜像真正起效的两个阶段
中文镜像只在以下两个环节提速，且效果显著：
-
Metadata 加载：拉取
packages.json、provider-*.json等索引文件。阿里云/华为云镜像响应通常 2s 甚至超时 -
Package 下载：从 dist ZIP 包（
--prefer-dist）下载。实测阿里云镜像平均 6–8MB/s，官方源常卡在 50–200KB/s
注意：parallel-downloads 必须配合镜像生效才有意义——若镜像没配对，设再高并发也只跑单线程。
配置镜像却没提速？90% 是这三个硬伤
镜像配置极易静默失效，必须逐项验证：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
repo.packagist键名写成repos.packagist（多一个 s），Composer 2.x+ 完全忽略，不报错 - 命令漏掉
composer类型参数：composer config -g repo.packagist https://...❌，正确是composer config -g repo.packagist composer https://...✅ - URL 少了结尾斜杠：
https://mirrors.aliyun.com/composer❌ → 返回 404；必须是https://mirrors.aliyun.com/composer/✅
验证是否真生效：composer config -g repo.packagist 输出必须是完整 JSON，形如 {"type":"composer","url":"https://..."}。空、null 或仍显示 packagist.org，说明根本没写进去。
CI/CD 和宝塔里镜像不生效的真相
你在终端用 root 配了全局镜像，但宝塔 PHP 进程以 www 用户运行，GitLab CI runner 用 gitlab-runner 用户，systemd 服务指定 User=www-data —— 全局配置只对当前 shell 用户生效。
- 查实际运行用户：
ps aux | grep php-fpm或看 CI 日志中的whoami - 用对应用户重配：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本中别依赖全局配置，改用临时参数更可靠：
COMPOSER_MEMORY_LIMIT=-1 php -d xdebug.mode=off $(which composer) install --no-dev --prefer-dist
大型单体应用里，最容易被忽略的是：镜像只是基础，真正的瓶颈往往藏在约束松散、lock 文件失真、Xdebug 开启这些本地因素里。换源只是第一步，不是万能解药。
