composer config -g repo.packagist 失效是因为键名必须为单数小写 repo.packagist、type 值 composer 不可省略、url 必须以 / 结尾且加 -g 参数，三者缺一即静默回退官方源。
composer 下载失败，基本不是网络“连不上”，而是它根本没走你配的镜像——静默 fallback 到 https://packagist.org，连错都不报。
为什么 composer config -g repo.packagist 看似执行了却没生效
这条命令失效不是 Composer 抽风，是三个硬性条件缺一不可：
-
repo.packagist必须是单数、全小写、不能多一个s（repos.packagist或mirror都无效） - 中间的
composer是type值，不是注释或可选参数——漏掉它，Composer 2.2+ 就当没配，直接回退官方源 - URL 必须是 HTTPS 且末尾带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致请求路径拼成/composerpackages.json，404）
验证是否真写进去了，只看这一行输出：composer config -g repo.packagist。正确返回应为类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON；空、null、报错、或只返回纯 URL 字符串，都说明没写成功。
全局配置在宝塔/Docker/CI 里为啥经常不生效
因为 -g 默认写进当前用户的 ~/.composer/config.json，而宝塔后台、Docker 容器、GitHub Actions runner 多数以 www 或 runner 用户运行，根本读不到你的配置。
- 临时解法：显式切换用户再配，比如
sudo -u www composer config -g repo.packagist composer https://mirrors.tuna.tsinghua.edu.cn/composer/ - 更稳做法：放弃全局，进项目根目录执行
composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/（不加-g），它会自动安全合并进composer.json的repositories字段 - 注意：
composer.json里已有"repositories": []数组时，该命令追加新项；若为"repositories": {}对象，则转为标准数组并插入"packagist"键
换完镜像还卡在 “Loading composer repositories” 怎么办
这不是镜像慢，是缓存和旧文件还在用旧地址：
-
composer clear-cache—— 清掉本地元数据缓存 - 删掉项目下的
vendor/和composer.lock - 再跑
composer install -vvv，盯着日志第一行Downloading https://...的域名是不是你配的镜像地址（比如mirrors.tuna.tsinghua.edu.cn） - 如果仍出现
packagist.org，立刻检查composer.json里是否残留了硬编码的"repositories"字段（尤其警惕已下线的laravel-china.org）
换源后仍报 Failed to download，可能不是镜像问题
镜像只管下载环节，不解决底层环境干扰：
-
curl error 60：系统 CA 证书过旧（常见于 macOS 或 Alpine Docker 镜像），可试composer config -g cafile /etc/ssl/certs/ca-certificates.crt - 公司代理未透传 HTTPS 流量：设好
http_proxy和https_proxy环境变量后，还需composer config -g github-oauth.github.com your_token - 缓存损坏导致的
Content-Length mismatch或unable to open archive：必须清缓存 + 删vendor+ 重装，硬重试只会循环失败 - 中断后残留的
installed.json被截断，会引发Invalid argument supplied for foreach()—— 这类错误不清理干净，后续所有安装都会挂
真正容易被忽略的是：Composer 没有断点续传，所谓“恢复”只是跳过已解压包；控制稳定性的关键是 --prefer-dist（强制走 ZIP 包）、--no-plugins（绕过老旧插件）、以及调高 process-timeout。
