确认当前源用 composer config -g repo.packagist，若显示 packagist.org 则需切换国内镜像；优先检查项目级 repositories 是否覆盖全局配置，执行 clear-cache 并验证 php 版本与 tls 兼容性。
国内用 composer install 卡在 Downloading https://packagist.org/packages.json？不是网络问题，是默认源在境外——换镜像就能解决，但换错或换不彻底，照样卡住、报错、装错包。
怎么确认当前用的是哪个源？
别猜，直接查：
composer config -g repo.packagist
如果输出是 {"type": "composer", "url": "https://packagist.org"}，说明还在走官方源。国内环境下，这个地址 DNS 解析慢、TCP 建连常超时、TLS 握手失败率高。
常见误判：以为执行过 composer config -g repo.packagist https://mirrors.aliyun.com/composer/ 就万事大吉——其实这条命令只改全局配置，项目级 composer.json 里若写了 "repositories"，会优先覆盖全局设置。
推荐镜像及对应命令（阿里云 / 清华 / 华为）
三个主流镜像目前都稳定，选一个执行即可，无需卸载重装：
- 阿里云（推荐）：
composer config -g repo.packagist https://mirrors.aliyun.com/composer/ - 清华大学：
composer config -g repo.packagist https://packagist.phpcomposer.com（注意：该域名已停用，正确地址是https://mirrors.tuna.tsinghua.edu.cn/composer/） - 华为云：
composer config -g repo.packagist https://repo.huaweicloud.com/repository/php/
⚠️ 注意：https://packagist.phpcomposer.com 已失效，强行使用会返回 404 或空响应，导致 composer update 报 Could not fetch packages.json 错误。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
为什么换了镜像还是慢或失败？
常见原因不是镜像本身，而是缓存和协议残留：
-
composer clear-cache必须执行——旧缓存里可能存着 packagist.org 的元数据，即使换源也不会自动刷新 - 检查是否启用了
HTTPS_PROXY或HTTP_PROXY环境变量，某些代理会干扰镜像直连 - 部分企业网络拦截了非标准端口或 SNI 域名，可临时加
-vvv查看实际请求 URL 和响应头：composer install -vvv - PHP 版本低于 7.2.5 时，某些镜像 TLS 配置不兼容，建议升级 PHP 或改用支持旧 TLS 的镜像（如华为云对 TLS 1.0/1.1 兼容性稍好）
项目级临时切换（不改全局）
团队协作或 CI 场景下，避免污染开发者全局配置：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令写入当前项目的 composer.json 的 repositories 字段，且优先级高于全局配置。删掉该字段或运行 composer config --unset repos.packagist 即可恢复。
注意：如果项目中已有自定义仓库（比如私有包），务必把镜像源放在 repositories 数组第一位，否则 Composer 可能先去私有源找所有包，导致漏匹配或重复下载。
镜像不是万能解药——它只加速元数据拉取和 ZIP 包分发，无法解决 ext-xxx 扩展缺失、PHP 版本不匹配、或 require-dev 中某包本身已废弃等问题。换完源第一件事，永远是跑一遍 composer diagnose，看有没有被忽略的配置冲突或证书警告。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
