根本原因是Packagist官方源国内访问不稳定，解决方法是切换为国内镜像源，如执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/全局生效。
为什么 composer install 卡在 downloading 或 timeout？
根本原因往往是默认的 Packagist 官方源（https://packagist.org）在国内访问不稳定，DNS 解析慢、连接超时、下载中断频繁。这不是你本地网络或 Composer 版本的问题，而是源本身地理和策略限制导致的。
解决思路不是换命令，而是换源——把 Packagist 请求代理到国内镜像站，比如阿里云、腾讯云或华为云提供的镜像服务。它们实时同步官方元数据，但走国内 CDN，响应快、成功率高。
怎么全局切换为阿里云镜像源？
执行一条命令即可生效，无需改项目配置：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会写入全局配置文件（通常是 ~/.composer/config.json），所有后续项目都会走阿里云镜像。验证是否生效：
composer config -g repo.packagist
输出应为：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 如果提示权限错误，加
sudo（macOS/Linux）或以管理员身份运行终端（Windows） - 不推荐用
--global以外的方式临时设置，容易混淆作用域 - 镜像 URL 结尾的
/不能省，否则部分版本会解析失败
项目级临时切换源（如 CI 环境或测试）
有些场景下你不想影响全局配置，比如 CI 流水线里要确保环境纯净，或者想对比不同镜像性能。这时用 -d 指定配置目录 + config 命令组合：
mkdir -p /tmp/composer-tmp && composer config -d /tmp/composer-tmp repo.packagist composer https://mirrors.tencent.com/composer/ && COMPOSER_HOME=/tmp/composer-tmp composer install
关键点：
-
-d指定的是 Composer 配置目录路径，不是项目路径 - 必须通过
COMPOSER_HOME环境变量让composer install读取该目录下的配置 - 腾讯云镜像（
https://mirrors.tencent.com/composer/）和华为云（https://repo.huaweicloud.com/repository/php/）也稳定，可按需替换 URL - 注意：这种写法不会修改任何已有配置，适合脚本化使用
遇到 Could not resolve packages 或 404 怎么办？
这通常不是镜像问题，而是镜像同步有延迟（一般不超过 5 分钟）或你引用了非 Packagist 托管的私有包（如 GitHub 仓库直连）。检查方式：
- 手动访问镜像 URL（如
https://mirrors.aliyun.com/composer/packages.json），看能否正常返回 JSON - 执行
composer clear-cache清掉本地缓存的旧元数据 - 若依赖含
"vcs": "git@github.com:..."类型，镜像源完全不生效，这类包仍走原始 Git 地址——此时需单独配 SSH 或 token 加速 - 某些企业防火墙会拦截 HTTPS 域名中的
mirrors.关键字，可尝试用 IP + Hosts 绕过（不推荐长期用）
镜像只是加速通道，它不改变依赖解析逻辑，也不解决包本身缺失或版本冲突。真正卡住的时候，先 composer why-not xxx 看冲突根源，再考虑源的问题。
