Composer install/update卡在Downloading或报Could not fetch，主因是packagist.org国内访问不稳定，应优先全局切换为阿里云镜像源：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。
Composer install 或 update 卡在 Downloading...、超时、报 Could not fetch 或直接提示 Connection refused，大概率不是你本地网络问题，而是默认源 https://packagist.org 在国内访问不稳定 —— 换国内镜像源是最快有效的解法。
确认当前使用的源是不是 packagist.org
执行命令查看当前配置：
composer config -g repo.packagist
如果输出是 {"type": "composer", "url": "https://packagist.org"} 或类似，默认源没改过。注意：项目级配置（composer.json 中的 repositories）会覆盖全局设置，优先检查项目根目录下是否有自定义源。
一键切换为阿里云镜像源（推荐）
阿里云镜像同步及时、响应快、无需认证，适合作为日常主力源。执行以下任一命令即可生效：
- 全局生效（所有项目都走镜像）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
- 仅当前项目生效：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
注意：composer config -g 修改的是 ~/.composer/config.json；如果该文件被手动编辑过，建议用 composer config -g -e 用编辑器打开核对，避免格式错误导致后续命令失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
遇到 404 或 “Invalid repository type” 错误
这类错误通常是因为镜像 URL 写错或协议不匹配。常见错误包括：
- 误写成
http://（阿里云镜像只支持https://） - 多写了末尾斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer//❌ - 用了已停服的旧源，如
https://packagist.phpcomposer.com（2022 年起已不可用） - 在 PHP 7.2 以下版本中，部分镜像 TLS 配置不兼容，可临时加
-vvv查看底层 cURL 错误详情
验证是否生效：运行 composer show -p，观察输出中 repositories 是否显示为阿里云地址；再试 composer require monolog/monolog，应能快速解析并下载。
需要临时切回官方源怎么办
某些包（尤其是私有包或带 VCS 约束的包）可能因镜像同步延迟无法立即获取最新版。此时可临时禁用镜像：
- 临时跳过镜像（本次命令生效）：
composer install --repository=https://packagist.org
- 恢复全局默认源：
composer config -g --unset repo.packagist
镜像不是万能代理 —— 它只缓存 public 包，不转发 private repository 请求；如果你的 composer.json 里明确写了私有仓库（如 "type": "git"），镜像不会干预，也不应干预。
