确认阿里云镜像是否生效需执行composer config -g repos.packagist，返回{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}才成功；若项目composer.json含repositories字段则优先级更高，会绕过镜像。
直接换阿里云镜像就能显著提升 Composer 下载速度，但必须确认当前镜像是否生效、是否被 composer.json 中的 repositories 覆盖，否则改了也白改。
怎么确认当前用的是哪个镜像
执行 composer config -g repos.packagist 查看全局镜像配置。如果返回 {"type": "composer", "url": "https://packagist.org"}，说明没切成功；返回 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 才是阿里云镜像。
- 注意：
composer config -g只查全局配置，项目级配置优先级更高，需额外检查项目根目录下的composer.json是否含repositories字段 - 如果项目里写了自定义仓库（比如私有包），Composer 会跳过 packagist 镜像，直接走那个地址——此时换镜像无效
- 运行
composer diagnose可看到「Checking composer.json: WARNING」提示，若出现「You should add a repository for packages not on packagist.org」之类，说明当前配置可能干扰镜像行为
全局切换到阿里云镜像的正确命令
执行以下命令即可生效（无需重启终端或清缓存）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令的关键点：
- 必须用
repo.packagist（不是repos.packagist或repositories），这是 Composer 识别主镜像的固定键名 -
composer是 type，不能省略；URL 末尾斜杠/建议保留，某些旧版 Composer 会因缺斜杠报 404 - 如果之前设过其他镜像（如腾讯云、华为云），这条命令会覆盖，不用先删
为什么有时换了还是慢？常见干扰项
即使镜像已切对，下载仍慢，大概率是以下原因：
- 项目中
composer.json含"repositories": [{"type": "composer", "url": "..."}]—— 这会完全绕过 packagist 镜像，所有包都从该 URL 拉取 - 依赖树里有大量未打 tag 的 dev 分支（如
"monolog/monolog": "dev-main"），Composer 会 clone 整个 git 仓库，而非下载 dist 包，速度取决于 GitHub/GitLab 本身 - 启用了
COMPOSER_DISABLE_XDEBUG_WARN=1或 xdebug 未关闭，会导致composer install解析阶段 CPU 占用高、响应卡顿（和镜像无关，但常被误判） - 阿里云镜像本身不代理 GitHub Release 资源（如
.zip/.tar.gz包），这些仍走原始 CDN，国内访问不稳定时会卡在「Downloading ...」
临时禁用镜像调试用法
想验证是否真由镜像导致问题，可临时绕过所有镜像直连官方源：
composer install --repository=https://packagist.org
或者更彻底地清掉所有自定义仓库逻辑：
composer install --no-plugins --no-scripts --repository=https://packagist.org
这样能排除插件、脚本、仓库配置的干扰，快速定位瓶颈在哪一层。
镜像只是加速 dist 包索引和元数据获取，真正耗时的环节往往藏在 git clone、压缩包解压、autoload 生成里——别把所有慢都归咎于镜像没换对。
