提升项目启动速度，从配置Composer中文镜像做起！-composer-PHP中文网

composer全局切换阿里云镜像是必要操作，运行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/即可一劳永逸生效，需先清除旧配置repos.packagist并验证输出，配合dns优化与缓存清理确保提速效果。

提升项目启动速度，从配置composer中文镜像做起！

Composer 默认源在国内下载极慢，切中文镜像能立竿见影提升 composer install 和 composer update 的启动与执行速度——这不是优化，是必要操作。

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

最省事的方式是改全局配置，一劳永逸，所有项目都生效：

运行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
执行后会写入 ~/.composer/config.json（macOS/Linux）或 %USERPROFILE%\Composer\config.json（Windows），无需手动编辑
验证是否生效：运行 composer config -g repo.packagist，输出应为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
注意：如果之前用过 composer config -g repos.packagist（旧写法），请先用 composer config -g --unset repos.packagist 清掉，否则新旧配置冲突导致镜像不生效

为什么不用腾讯云或华为云镜像

不是它们不好，而是阿里云镜像稳定性、同步频率和 CDN 覆盖更可靠：

Discussion Composer

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

下载

腾讯云镜像偶尔出现 502 或同步延迟（尤其凌晨时段），composer update 可能卡在 Downloading https://mirrors.cloud.tencent.com/composer/p2/... 不动
华为云镜像域名曾多次变更（如从 repo.huaweicloud.com 切到 mirrors.huaweicloud.com），旧配置易失效
阿里云地址长期稳定，且支持 HTTP/2 和完整 SSL，composer 1.10+ 和 2.x 均无兼容问题

项目级镜像配置的适用场景

全局换镜像虽快，但某些场景必须项目内单独配：

团队协作时需确保所有人走同一源（避免有人漏切镜像，CI 构建失败）：在项目根目录运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/
临时测试某私有包，需叠加自定义源：用 composer config repositories.myprivaterepo composer https://your-internal-repo.com，此时不能依赖全局镜像

注意：composer.json 中的 repositories 会完全覆盖默认源（包括你刚设的阿里云镜像），若要保留 packagist 镜像又加私有源，必须显式写出完整结构，例如：

{
  "repositories": [
    {
      "type": "composer",
      "url": "https://mirrors.aliyun.com/composer/"
    },
    {
      "type": "composer",
      "url": "https://your-internal-repo.com"
    }
  ]
}

镜像切了还是慢？先检查这三件事

常见“已切镜像但没变快”的真实原因往往不在镜像本身：

本地 DNS 解析慢：尝试 ping mirrors.aliyun.com，若超时或延迟 >100ms，改系统 DNS 为 223.5.5.5 或 114.114.114.114
composer.lock 文件锁定了旧版本依赖，composer install 不走远程源；真正提速靠的是 composer update ——但后者本身也依赖镜像，所以得先确保镜像生效再跑
PHP OPcache 或 Composer 自身缓存干扰：运行 composer clear-cache，并确认 opcache.enable=1 在 CLI 模式下也开启（查看 php -i | grep opcache）