直接换源可解决下载慢等问题，但需同时满足三个条件：键名必须为repo.packagist（单数）、type值必须为composer、url须为https且末尾带斜杠；项目级配置更可靠，应优先使用。
直接换源就能解决下载慢、卡死、报错问题，但90%的人配不成功——不是网络被墙，是composer config -g repo.packagist命令写错了三个硬性条件。
为什么composer config -g repo.packagist命令总不生效？
这条命令静默失败时不会报错，但composer config -g repo.packagist返回空或null，说明根本没写进去。必须同时满足：
-
repo.packagist是唯一合法键名（注意是repo单数，不是repos；也不能写成packagist.org） - 中间的
composer是type值，不是可选参数——漏掉就 fallback 到官方源 - URL 必须用 HTTPS，且末尾斜杠
/不能少（少斜杠会拼出/packages.json导致 404）
正确写法：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
项目级配置比全局更可靠，尤其适合团队和 CI
全局配置在 CI 流水线（如 GitHub Actions）、宝塔面板（以www用户运行）或同事拉代码后经常失效——因为它们读不到你本地用户的~/.composer/config.json。
- 进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 它会自动在
composer.json顶层写入"repositories"字段，key 固定为"packagist" - 如果项目已有
"repositories"数组，该命令会合并而非覆盖；手动编辑时务必保持 JSON 合法，尤其末尾不能多逗号 - 改完建议删掉
vendor/和composer.lock，再跑composer install确保从新源拉取
换源后仍卡在 “Resolving dependencies”？和镜像无关
镜像只加速元数据加载和 ZIP 包下载，不参与依赖解析。卡在这里基本是composer.json写法或环境问题：
- PHP 版本约束太宽，比如
"php": "^7.4 || ^8.0"，让 Composer 尝试遍历大量不兼容版本 -
require-dev里塞了太多工具链（如phpunit、phpstan、friendsofphp/php-cs-fixer），大幅增加解空间 - 用了已废弃的
fxp/composer-asset-plugin（常见于老版 Yii2），它绕过 Composer 镜像机制，直连 Bower/NPM 源
这类问题换任何镜像都无效，得收紧约束、拆分 dev 包、或升级到原生 asset 管理方案。
验证是否生效，别靠感觉
执行composer config -g repo.packagist，输出必须是类似{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}的完整结构。如果返回空、null、或报Key not found，说明没配对——立刻检查repo.packagist拼写、composer类型字、以及 URL 末尾斜杠。
项目级配置则直接打开composer.json，确认顶层有"repositories"字段，且其中"packagist"对象的url指向国内地址，同时没有"packagist.org": false这类禁用默认源的配置。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
