Composer install卡在Downloading或报超时，根本原因是直连国外Packagist源（https://packagist.org）受网络路由、DNS及TCP连接不稳定影响，并非本地网络或Composer故障；必须切换阿里云或腾讯云镜像源并执行composer clear-cache验证生效。
Composer 默认源在国外，国内直连经常超时或 404，换镜像不是“试试看”，而是必须做的第一步。
为什么 composer install 卡在 Downloading... 或报 Connection timed out
根本原因是 Packagist 官方源（https://packagist.org）服务器位于欧洲，国内运营商路由不稳定，DNS 解析慢、TCP 连接常被重置，尤其在凌晨或高峰期。这不是你网络差，也不是 Composer 本身坏了——是源没换。
- 错误典型表现：
Failed to download vendor/package: The "https://api.github.com/..." file could not be downloaded (HTTP/2 403)（实际是前置源请求失败导致后续 GitHub Token 验证异常） - 别先查
github.com是否能访问——先确认composer config -g repo.packagist返回的是不是https://packagist.org - 临时验证：运行
curl -I https://packagist.org/packages.json，如果耗时 >5s 或返回503，就该切镜像了
怎么快速切换到阿里云或腾讯云镜像？
用 composer config 全局设置，比改 composer.json 更可靠，避免团队协作时遗漏。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 阿里云镜像（推荐）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 腾讯云镜像：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 切完立刻清缓存：
composer clear-cache，否则旧包可能仍从原源拉取 - 验证是否生效：
composer config -g repo.packagist应输出对应镜像 URL，不是{"type": "composer", "url": "..."}这种 JSON 结构
为什么用了镜像还报 Package not found？
镜像同步有延迟（通常 5–30 分钟），新发布的包或 dev 分支可能还没同步过来，不是配置错了。
- 先查包是否真在镜像中：
curl -s "https://mirrors.aliyun.com/composer/p2/vendor/package.json" | head -20，返回404就说明尚未同步 - 临时回退官方源单次安装：
composer install --repository=https://packagist.org，但仅限紧急场景 - 别混用镜像和自定义
repositories：如果composer.json里写了私有仓库，确保其type是composer且 URL 可访问，否则会干扰主源行为
镜像不是万能解药——有些包依赖 GitHub 的 dist ZIP，而镜像只代理 packages.json 和 metadata，实际 ZIP 仍走 GitHub；这时得配 COMPOSER_DISABLE_FUNCTIONS 或用 git clone 方式，但那是另一个问题了。
