运行 composer config -g repo.packagist，若输出 https://mirrors.aliyun.com/composer/ 则为阿里云镜像；若为 https://packagist.phpcomposer.com 或空则未切换成功；注意项目级配置优先级更高，需检查 composer.json 中的 "repositories" 字段。
怎么确认当前 Composer 镜像源是不是阿里云
直接运行 composer config -g repo.packagist，它会输出当前全局配置的 Packagist 源地址。如果返回的是 https://packagist.phpcomposer.com 或空，说明没切成功；如果是 https://mirrors.aliyun.com/composer/，那就对了。
注意：这个命令只查全局配置，项目级配置（composer.json 同目录下的 composer.lock 或 composer.json 里写的源）优先级更高，得一起看。
- 项目根目录下有
composer.json，且里面包含"repositories"字段，就以它为准 -
composer config -g repo.packagist查的是全局镜像，适合大多数本地开发场景 - 某些旧版 Composer（repo.packagist 这种简写，得用完整字段名：
composer config -g repos.packagist
一键切换到阿里云镜像的正确命令
执行这行命令就能把全局源换成阿里云：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
别漏掉中间的 composer ——这是类型标识，不是拼写错误。少了它，Composer 会当成自定义仓库名处理，导致后续 require 失败。
- 如果提示
Could not find package ...，大概率是这一步输错了类型参数 - 换完后建议跑一次
composer clear-cache，避免旧缓存干扰 - 国内服务器部署时，建议在 CI/CD 脚本开头加这行，别依赖本地配置
为什么有时切了镜像还是慢或报错
阿里云镜像本身没问题，但常见卡点不在源地址本身，而在网络路径和协议协商上。
- 公司内网或教育网可能拦截或限速
https://mirrors.aliyun.com的 SNI 请求，可临时试http://mirrors.aliyun.com/composer/（不推荐长期用，无校验） - PHP 版本太低（如 7.0 以下）可能不支持阿里云 TLS 1.2+ 握手，会卡在
file could not be downloaded - 如果你用的是 Laravel Sail、Docker Desktop 等容器环境，宿主机换了镜像，容器里还得单独配一次
- 部分私有包仍走原始 Packagist，阿里云镜像只代理公开包，私有包要单独配
repositories
项目级临时覆盖镜像的写法
不想改全局配置？在项目 composer.json 里加一段就行：
{
"repositories": [
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
]
}
这样 composer install 就只对当前项目生效。注意两点：
- 必须是数组，哪怕只写一个源；不能写成对象直接丢进去
- 如果已有其他
repositories条目（比如私有 GitLab 包），要把阿里云这条放在最前面，否则优先级不够 - 改完记得删掉
composer.lock再composer install，不然锁文件还记着旧源
有些团队会把镜像切换写进 Dockerfile 的 RUN 行，但要注意 PHP 扩展缺失（比如 curl、openssl）会导致 HTTPS 请求直接失败——这种底层问题比镜像地址本身更常卡住人。
