答案是换国内镜像源、清缓存、加--prefer-dist --no-dev参数三步缺一不可：执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意单数repo、type值composer、URL末尾斜杠），再运行composer clear-cache，最后安装时加上--prefer-dist --no-dev -vvv确认请求域名。
composer 下载 Symfony 扩展慢，90% 不是网速问题，而是还在直连 packagist.org —— DNS 污染、TLS 握手卡顿、CDN 绕行导致假性“卡死”。换国内镜像源 + 清缓存 + 选对参数，能从几分钟压到几秒。
执行全局镜像配置时命令必须写对三个硬点
很多人执行了 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 却没生效，不是网络问题，是命令漏了关键要素：
-
repo.packagist不能写成repos.packagist（多一个 s 就静默失效） - 中间的
composer是 type 值，不是注释或可选参数——漏掉它，Composer 2.x 会直接 fallback 到官方源 - URL 必须是 HTTPS 且末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致 404）
验证是否成功：运行 composer config -g repo.packagist，输出应为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 或新版纯 URL 字符串。空、null、或仍是 https://packagist.org，说明没写进去。
换源后仍卡在 Downloading？必须清缓存
镜像配置只是告诉 Composer 去哪拉元数据，但旧缓存里还存着海外源的 packages.json 和 ZIP 包哈希。不清理，Composer 会继续尝试从 repo.packagist.org/dist/ 下载，结果就是卡在 TLS 握手或 DNS 解析。
立即执行：
composer clear-cache
清完再跑 composer require symfony/validator 或其他扩展，才能真正走阿里云 CDN。别跳过这步——这是最常被忽略的“断点”。
安装 Symfony 扩展时加 --prefer-dist --no-dev 能省一半时间
Symfony 生态扩展（如 symfony/form、symfony/security-bundle）依赖多、体积大，尤其含大量 dev-only 工具包。默认会拉 Git 仓库 + 全量依赖树，拖慢速度。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
推荐组合参数：
-
--prefer-dist：强制下载 ZIP 包，跳过 Git 克隆（对只有dev-main分支的包尤其关键） -
--no-dev：跳过require-dev中的包（如 PHPUnit、PHPStan），节省 60%+ 时间和磁盘空间 -
-vvv：显示真实请求 URL，确认是否真从mirrors.aliyun.com拉取
示例：
composer require symfony/mailer --prefer-dist --no-dev -vvv
宝塔、Docker、CI 环境中镜像配置容易失效
全局配置写在 ~/.composer/config.json，但「谁在跑命令」决定读哪个文件：
- 你在终端用
root配了镜像，但宝塔「一键部署」是以www用户运行的，它读的是/home/www/.composer/config.json - CI 脚本里
sudo composer config -g写进了root配置，而构建容器里实际用的是runner用户
解决方法很直接：先确认执行用户（whoami 或查日志 UID），再切过去配：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
项目级配置更稳妥：进项目根目录，运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），它会自动写入 composer.json 的 repositories 字段，Git 提交后所有人行为一致。
Resolving dependencies 卡顿。如果 composer update 停在这一步超过 10 秒，得收紧 composer.json 版本约束、禁用 Xdebug、检查 config.platform.php 是否匹配当前 PHP 版本——这些和镜像无关，但常被误判。 
