composer默认源packagist.org在国内访问慢、易超时，换阿里云镜像可显著改善；执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/全局生效，末尾斜杠不可省略。
Composer 默认源在国内访问慢、易超时，直接导致 composer install 卡住、symfony new 失败，甚至某些依赖无法解析——这不是项目问题，是网络环境限制，换镜像就能显著改善。
如何确认当前 Composer 使用的是哪个源
执行 composer config -g repo.packagist 查看全局配置；若返回空或 {"type": "composer", "url": "https://packagist.org"}，说明正走官方源。开发 Symfony 项目时，尤其在初始化阶段（如 symfony new my_project）会高频拉取 symfony/skeleton 及其数百个依赖，此时官方源响应延迟常达 10–30 秒/请求，极易触发 Connection timeout 或 Could not resolve packages 错误。
建议用以下命令快速验证镜像是否生效：
composer show symfony/framework-bundle -v | grep "Downloading"
若看到 URL 中含 mirrors.aliyun.com 或 packagist.phpcomposer.com，说明已切换成功。
推荐的中文镜像及切换方式
目前稳定可用的有阿里云、腾讯云、华为云三家镜像，其中阿里云 https://mirrors.aliyun.com/composer/ 更新最及时（同步延迟通常 symfony/ux-* 系列）。
切换方法分两种场景：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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/ - 仅当前项目切换（CI/CD 或多源调试时）：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不带-g） - 若曾手动改过
~/.composer/config.json，请先删除其中"repositories"下的自定义项，避免冲突
不建议使用已停止维护的 packagist.phpcomposer.com，其自 2023 年起不再同步新包，会导致 symfony/console ^6.4 等较新版本无法安装。
Symfony 项目初始化时的镜像配合技巧
symfony new 命令底层仍调用 Composer，但默认不继承全局镜像配置——它会启动一个独立的 Composer 实例，忽略用户配置。因此必须显式指定镜像，否则新建项目仍可能失败。
正确做法是：
- 先确保全局镜像已设好（见上一节）
- 再运行
symfony new my_app --version=stable，而非--full（后者会拉更多 UX 组件，对网络更敏感） - 若仍卡在
Installing dependencies，可临时加-v参数观察具体卡在哪一包，再单独用composer require vendor/package测试该包是否可拉取
另一个隐藏坑：Symfony CLI 有时会缓存旧的包元数据。遇到 Could not find package symfony/webapp-pack 类错误，先运行 composer clear-cache 再重试，比反复切镜像更有效。
镜像不是万能解药：哪些情况仍会失败
换镜像解决的是「包索引下载」和「zip 包分发」环节的网络问题，但以下情况不受影响：
- GitHub/GitLab 源码仓库直连（如
"type": "vcs"的私有包），仍走原始 Git 地址，需自行配置git config --global url."https://github.fastgit.org/".insteadOf "https://github.com/" - 某些包在
composer.json中硬编码了dist.url（如指向 GitHub Releases），镜像无法代理，需手动 patch 或联系作者修正 - Symfony Flex 服务器（
flex.symfony.com）本身不走 Composer 镜像，若composer recipes卡住，属于 Flex 服务波动，与镜像无关
真正影响效率的，往往是组合问题：镜像 + Git 加速 + Flex 可用性三者缺一不可。只换 Composer 镜像，却忽略 GitHub 访问问题，依然会在 require 含 Git 子模块的包时卡住。
