直接执行 composer config -g repo.packagist https://mirrors.aliyun.com/composer/ 即可全局切换至阿里云镜像，该命令修改 ~/.composer/config.json 并覆盖旧配置，确保全局命令（如 create-project、global update）及 ci 环境均走国内加速源。

Composer 默认源在国内下载极慢，甚至超时失败，直接换阿里云或腾讯云镜像能立竿见影提升安装和更新速度。

怎么全局切换到阿里云 Composer 镜像

执行一条命令即可覆盖全局配置，后续所有项目都走国内加速源：

• 运行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 该命令会修改 ~/.composer/config.json，你可手动检查确认 "repo.packagist" 字段已更新
• 如果之前用过其他镜像（比如华为云），这条命令会覆盖掉旧配置，无需先清理
• 注意：不是 https://packagist.phpcomposer.com（已停用），也不是 http:// 开头（部分 Composer 版本会拒绝非 HTTPS 源）

为什么不能只改当前项目的 composer.json

项目级配置只影响当前目录，但日常开发中常遇到这些场景：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 全局安装工具如 phpunit/phpunit、laravel/installer，它们走的是全局源，不读项目 composer.json
• 执行 composer create-project 时，初始包拉取也依赖全局源
• 某些 CI 环境（如 GitHub Actions）默认无项目目录，靠全局配置兜底
• 项目 composer.json 中的 repositories 仅对该项目 require 的包生效，不控制 Composer 自身行为

composer global update 卡住？先检查镜像是否生效

全局命令卡在 “Loading composer repositories” 阶段，大概率是镜像没生效或被本地配置覆盖：

• 运行 composer config -g -l，确认输出里 repo.packagist 的值是 https://mirrors.aliyun.com/composer/
• 检查是否有项目级配置干扰：进入任意空目录执行 composer config -l，若显示 repo.packagist 为原始地址，说明全局配置被覆盖（常见于公司脚手架模板自带 composer.json）
• 某些旧版 Composer（composer self-update 最新版再试
• 阿里云镜像偶尔同步延迟，可临时切腾讯云：composer config -g repo.packagist https://mirrors.cloud.tencent.com/composer/

镜像只是第一步；真正复杂的是私有包、多源混用、以及企业内网环境下自建镜像的证书与认证问题——那些得单独配 repositories 和 auth.json，别指望一条命令全解决。