永久切换 Composer 全局镜像源为阿里云，执行命令 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，该命令写入用户级配置文件（如 ~/.composer/config.json），使所有项目默认使用该镜像；验证方式为运行 composer config -g repo.packagist，输出应为对应 URL。
Composer 默认走国外源，国内直连经常超时、卡死或安装失败，直接改 composer.json 或全局配置镜像源是最有效解法，无需装额外工具。
如何永久切换到阿里云镜像源
执行一条命令即可覆盖全局配置，后续所有项目都生效：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否生效：运行 composer config -g repo.packagist，输出应为 https://mirrors.aliyun.com/composer/。注意不是 https://packagist.org，也不是带 /packages.json 后缀的地址。
- 该设置写入
~/.composer/config.json（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Composer\config.json（Windows），优先级高于项目级配置 - 如果之前用过
composer config -g repositories.packagist这类旧写法，会冲突，建议先执行composer config -g --unset repositories.packagist清理 - 某些 CI 环境（如 GitHub Actions）默认不读全局配置，需在 workflow 中显式设置
COMPOSER_HOME或使用项目级配置
仅对当前项目启用镜像源（推荐用于协作项目）
避免影响其他项目，且能随代码提交被团队共享：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会向当前项目的 composer.json 写入 repositories 字段，生成类似如下结构：
"repositories": {
"packagist": {
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
}
- 务必确认没有同时存在
"packagist.org": false这类禁用默认源的配置，否则镜像源可能被忽略 - 如果项目已存在
repositories数组，该命令会合并而非覆盖；手动编辑时注意 JSON 格式合法，尤其是末尾逗号 - 执行后建议删掉
vendor/和composer.lock，再运行composer install确保依赖从新源拉取
遇到 “Could not fetch” 或 “file could not be downloaded” 怎么办
这类错误大概率是镜像源同步延迟或临时不可用，不是本地配置问题：
- 先检查镜像状态：
curl -I https://mirrors.aliyun.com/composer/packages.json，返回200 OK表示服务正常 - 尝试换源：腾讯云镜像更稳定，命令为
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 若只在
require某个包时失败，可能是该包未被镜像收录（小众私有包或刚发布），可临时关闭镜像：composer config -g repo.packagist composer https://packagist.org -
composer clear-cache必须执行，镜像元数据缓存过期会导致重定向失败
镜像源本质是代理，不改变包内容或版本规则，但同步有数分钟延迟；生产环境部署前建议用 composer install --no-dev + 锁定 composer.lock，避免因镜像滞后引入意外变更。
