直接换镜像源能解决90%的composer install卡在downloading或loading repositories的问题，主因是默认源packagist.org对国内用户dns慢、tls不稳定；配置必须同时满足键名repo.packagist（单数）、type值为composer、url以https://开头且末尾带/，缺一则静默回退官方源。
直接换镜像源能解决 90% 的 composer install 卡在 Downloading 或 Loading composer repositories 的问题——不是你网络差，是默认源 https://packagist.org 对国内用户 DNS 解析慢、TLS 握手不稳定、CDN 距离远。配错一个字符，Composer 就静默回退官方源，不报错也不提醒。
composer config -g repo.packagist 命令为什么总不生效
它不报错，但根本没走镜像，几乎全是这三个硬性条件漏掉一个：
-
repo.packagist必须是单数、小写、无多余字符；写成repos.packagist（多 s）、packagist（少 repo.）或mirror都无效 - 中间的
composer是必需的type值，不是可选参数；漏掉它，Composer 2.x 直接 fallback 到官方源 - URL 必须是
https://开头，且末尾带/：例如https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会拼成/composerpackages.json，返回 404）
验证是否真写进去了：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象（如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}）或至少是完整 URL 字符串；空、null、或仍是 https://packagist.org，说明根本没写成功。
项目级配置比全局更可靠，尤其在 CI/CD 和团队协作中
全局配置容易被权限覆盖（比如宝塔用 www 用户执行，而你配的是 root 的配置），项目级配置写进 composer.json，拉代码即生效，行为可预期：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/（注意不加-g） - 该命令会自动向
composer.json的repositories字段追加条目，不破坏已有私有源；如果"repositories": {}，它会转为数组并插入；如果是"repositories": []，就追加到末尾 - 千万别手动写
"packagist": false——这会导致php、ext-json等基础扩展校验失败 - 改完后立刻运行：
composer update --lock，确保composer.lock记录的是镜像源地址，而非官方源
换镜像后仍卡在 Downloading？先清缓存再重装
镜像只加速下载环节，但旧缓存里存着 packagist.org 的元数据，Composer 会优先读缓存并尝试从旧地址校验，结果就是卡在 DNS 或 TLS 握手——不是没走镜像，是根本没发请求过去：
- 必须执行：
composer clear-cache - 删掉
vendor/和composer.lock - 再跑：
composer install --no-cache（禁用缓存强制走新源） - 别试图保留旧
composer.lock——它记录的是旧源的包哈希，和镜像返回的元数据不兼容，必然报hash does not match
验证是否真走镜像，不能只看 config 输出；必须加 -vvv：运行 composer install -vvv 2>&1 | grep "Downloading"，日志里出现 mirrors.aliyun.com 或对应镜像域名才算真正生效。
CI/CD 中 Composer 加速必须三要素齐备
GitHub Actions 或 GitLab CI 里 Composer 不快，不是因为“没中文支持”，而是镜像没切对、缓存路径错了、参数漏了：
- 镜像源必须切对：验证
composer config -g repo.packagist输出完整 JSON，且 URL 含末尾斜杠；CI 脚本里避免用sudo composer config -g（可能写进root配置，但 runner 用户读不到） - 缓存路径必须是
~/.composer/cache，不是vendor/；vendor/缓存危险：不同 PHP 版本、扩展开关（如ext-apcu）、甚至文件系统大小写敏感性，都会导致 autoload 文件不兼容 - 安装时必须带参数：
--no-dev --prefer-dist --optimize-autoloader --no-interaction；缺一不可，否则耗时难压到 30 秒内
最常被忽略的一点：composer.lock 文件没提交，导致 CI 缓存 key 不匹配，缓存失效——换镜像只是第一步，环境一致性才是提速落地的关键。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
