composer默认源packagist.org在国内访问慢，换阿里云镜像可解决元数据和zip包下载超时问题；执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/即可全局生效，末尾斜杠不可省略。
为什么 Composer 默认源慢，换阿里云镜像能解决什么问题
Composer 默认使用 packagist.org，国内直连常出现超时、卡在 Updating dependencies 或报错 Connection timed out。阿里云镜像（https://mirrors.aliyun.com/composer/）是官方认可的国内镜像，响应快、同步及时，但注意它只代理包元数据和 ZIP 文件，不托管 Git 仓库——所以 git clone 类操作仍走原地址，这点常被忽略。
全局设置阿里云镜像的正确命令
执行一条命令即可覆盖全局配置，无需手动编辑 composer.json 或 config.json：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会写入用户级配置文件（通常是 ~/.composer/config.json），优先级高于项目级配置。常见错误是漏掉 -g 参数，导致只改当前项目，或者误用 composer config --global 语法（实际不支持双横线写法）。
- 验证是否生效：运行
composer config -g repo.packagist，应输出https://mirrors.aliyun.com/composer/ - 若提示
Command "config" is not defined，说明 Composer 版本过低（低于 1.0），需先升级：composer self-update - 如果公司网络有代理或防火墙，即使换了镜像也可能失败，此时需额外配置
http-proxy，而非反复换源
临时切换回官方源或禁用镜像
某些包（如私有包、未同步到镜像的测试版）可能因镜像延迟而安装失败，这时需要临时切回官方源：
composer config -g repo.packagist composer https://packagist.org/
或者更彻底地清空镜像设置（恢复默认行为）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config -g --unset repos.packagist
注意：--unset 是移除键值，不是设为空字符串；设为空会导致 Composer 解析异常，报错 Invalid repository type: 。
项目级镜像设置与多源共存场景
团队协作时，有时需要项目固定用阿里云镜像，但又不想影响全局——这时在项目根目录执行（不加 -g）：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
该配置写入项目下的 composer.json 的 repositories 字段。但要注意：
- 若项目已有自定义
repositories数组，这条命令会覆盖整个数组，不是合并；建议直接编辑composer.json手动追加 - 当全局和项目都设置了镜像，项目级优先级更高，但若项目中
repositories包含了 type=package 或 vcs 类型源，它们不受 packagist 镜像影响 - CI 环境中建议用全局设置，避免每次
composer install前还要初始化项目配置
镜像不是万能解药，真正卡住的时候，先看是不是 composer.lock 里锁了旧版本依赖，或者 PHP 版本不匹配导致解析失败——换源解决不了这些。
