怎么开启国内源 Composer怎么还原默认镜像

你可以通过 composer config -gl 命令来查看当前的仓库地址。
如果要修改，按以下步骤

怎么全局开启阿里云或腾讯云镜像源

直接改 Composer 的全局配置，所有项目立刻走国内源，不用每个项目单独设。这是最省事、也最推荐的起步方式。

• 阿里云镜像（同步快、稳定性高，首选）：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 腾讯云镜像（南方用户延迟更低）：composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
• 中国科大镜像（学术网络友好）：composer config -g repo.packagist composer https://mirrors.ustc.edu.cn/composer/

注意：repo.packagist 是固定键名，不是 repos.packagist —— 写错字段名会导致配置无效，且不会报错，容易误以为“设成功了”。

为什么有些命令没生效？常见配置陷阱

配置后 composer install 还慢，或者 composer config -g repo.packagist 返回空，大概率是掉进了这几个坑：

• 之前用过旧镜像（比如 Laravel China 或 phpcomposer），残留了 repos.packagist（带 s）配置，和新的 repo.packagist 冲突，得先清理：composer config -g --unset repos.packagist
• 执行命令时漏了 -g，结果只改了当前项目（写入了 composer.json），但你其实想全局改
• 用了 sudo 或切换了用户执行命令，导致改的是另一个用户的 ~/.composer/config.json
• 验证方式错误：别只看 composer config -g，要加具体字段：composer config -g repo.packagist，输出应为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}

怎么只对当前项目启用镜像（不污染全局）

适合团队协作、CI 构建，或你只是临时测试某个镜像效果。它会把配置写进当前项目的 composer.json，不影响其他项目。

• 进入项目根目录后执行（以阿里云为例）：composer config repo.packagist composer https://mirrors.aliyun.com/composer/
• 该命令会向 composer.json 插入 "repositories" 字段，结构如下：

"repositories": {
  "packagist": {
    "type": "composer",
    "url": "https://mirrors.aliyun.com/composer/"
  }
}

如何干净还原到官方源（恢复默认）

不是简单换回 URL，而是彻底移除自定义源配置，让 Composer 自动 fallback 到 https://packagist.org。

• 全局还原（所有项目）：composer config -g --unset repos.packagist
• 仅当前项目还原：composer config --unset repositories.packagist（注意这里用 --unset 而非 repo.packagist）
• 还原后建议清缓存：composer clear-cache，避免旧镜像的元数据干扰依赖解析

别用 composer config -g repo.packagist composer https://packagist.org —— 这样只是硬编码官方地址，仍属于“自定义源”，后续升级 Composer 可能行为异常；真正干净的做法是删掉配置项本身。

最容易被忽略的一点：镜像源解决的是「索引获取慢」，不是「包文件下载慢」。如果 composer update 卡在 downloading zip 包阶段，问题可能出在 CDN 或本地网络，跟镜像源关系不大。这时候该查的是 composer diag 输出里的 HTTP proxy 或 openssl version 是否异常。