正确命令是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，必须严格满足三要素：键名repo.packagist（非repos）、type值composer不可省略、url须为https且末尾带斜杠；缺一即静默失效。
composer config -g repo.packagist 命令必须写对三处
配错一个字符，Composer 就当没这回事——不报错、不提示、照连 packagist.org。最常踩的坑是：repo.packagist 写成 repos.packagist（多一个 s），composer 这个 type 值漏掉，或者 URL 少了末尾斜杠 /。
正确命令只有一条：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
-
repo.packagist是唯一合法键名，拼错就静默失效 - 中间的
composer是type值，缺了它 Composer 2.x 会 fallback 到默认源 - URL 必须 HTTPS + 末尾
/，否则路径拼接出错，返回404
项目级配置比全局更可靠
全局配置容易被覆盖或权限干扰（比如宝塔面板用 www 用户执行，但你配的是 root 的 config）；项目级配置直接写进 composer.json，拉代码即生效，CI 构建时不用额外 setup。
进项目根目录后运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
- 该命令自动向
composer.json的repositories字段追加packagist条目，不覆盖已有私有源 - 如果项目已有
"repositories": {}，别手动编辑 JSON——格式错一个逗号就导致composer install报错 - 确认生效后，
composer.json中应出现类似："packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
换源后仍卡在 Downloading？先清缓存再重装
镜像只加速下载，但旧缓存里存着 packagist.org 的元数据，Composer 会优先读缓存并尝试从旧地址校验，结果就是卡在 DNS 或 TLS 握手——不是没走镜像，是根本没发请求过去。
- 必须执行：
composer clear-cache - 删掉
vendor/和composer.lock - 再跑：
composer install --no-cache（禁用缓存强制走新源） - 别试图保留旧
composer.lock——它记录的是旧源的包哈希，和镜像返回的元数据不兼容，必然报hash does not match
验证是否真走镜像，不能只看 config 输出
光跑 composer config -g repo.packagist 显示 URL 没用，得看到网络请求实际打到镜像域名才算数。
实测命令：
composer show monolog/monolog -vvv 2>&1 | grep "Downloading"
- 日志里必须出现
mirrors.aliyun.com或mirrors.cloud.tencent.com等镜像域名 - 如果看到
https://packagist.org或repo.packagi，说明配置没生效或缓存没清干净 - PHP 8.5.5 下尤其要注意：Xdebug 启用会让依赖解析慢 5 倍以上，CI 或本地调试前先关掉
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
