composer配置中文镜像总不生效是因为必须同时满足三个硬性条件：键名严格为repo.packagist（单数小写无s）、中间参数composer为必填type值、url须https且末尾带/，任一错误均静默回退官方源。
配中文镜像本身不难，难在配完“看起来成功”却根本没走镜像——Composer 2.x 会静默 fallback 到 https://packagist.org，连个警告都没有。真正稳定的配置，必须同时满足三个硬性条件，缺一不可。
composer config -g repo.packagist 命令为什么总不生效
这不是网络问题，是命令写错了。Composer 只认 repo.packagist 这个键名（单数、小写、无 s），且必须带 -g、中间的 composer 是 type 值（不是注释）、URL 必须是 HTTPS 且末尾带 /。
-
repos.packagist、packagist.org、Repo.Packagist→ 静默忽略，查composer config -g repo.packagist返回空或null - 漏掉
composer：比如写成composer config -g repo.packagist https://mirrors.aliyun.com/composer/→ 完全无效，仍走官方源 - URL 少斜杠：
https://mirrors.aliyun.com/composer→ 请求拼成/composerpackages.json，返回 404，Composer 直接弃用该镜像 - 用了 HTTP：
http://开头 → Composer 2.5+ 默认拒绝，连接直接中断
验证镜像是否真在用，别信“配完了”这种感觉
执行 composer config -g repo.packagist，输出必须是完整 JSON 对象：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
如果不是这个格式，说明没配对。常见假阳性：
- 输出为空、
null或报Key not found→ 根本没写进去 - 只输出一个 URL 字符串（如
"https://mirrors.aliyun.com/composer/"）→ 缺type字段，新版 Composer 不认 - 输出仍是
"https://repo.packagist.org"→ 配置被覆盖或压根没生效
更可靠的做法是加 -vvv 跑一次 composer install，看日志里实际请求的是 mirrors.aliyun.com 还是 packagist.org。
项目级配置比全局更可靠，尤其在 CI/CD 和团队协作中
全局配置写在 ~/.composer/config.json，但 CI 流水线用 runner 用户、宝塔用 www 用户、Docker 容器甚至没有这个目录——你本地配了，别人照样卡住。
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加-g） - 这条命令会自动 merge 进
composer.json的repositories字段，不破坏已有私有源（前提是原字段是对象{}，不是数组[]） - 改完必须立刻执行：
composer update --lock，否则composer.lock里记录的还是旧源地址 - 如果
composer.json里已有"packagist.org": false，得删掉或改成true，否则镜像会被直接屏蔽
换源后依然卡在 “Loading composer repositories”，该清什么、不该信什么
镜像只影响元数据和 ZIP 包下载路径，不解决缓存污染、锁文件错位或项目级配置覆盖问题。
- 必须执行：
composer clear-cache—— 否则旧缓存里的packages.json还是从官方源来的 - 必须删掉：
vendor/和composer.lock—— 锁文件里的 hash 和校验路径来自旧源，和镜像不匹配就会中断 - 别指望
composer update重走镜像流程 —— 它只基于现有composer.lock解析，要彻底切换，必须删 lock 后重装 - 别跳过权限检查：Linux/macOS 下若提示
Permission denied，先chown -R $USER $(composer config -g home)再重试
当前稳定可用的镜像只有三个：https://mirrors.aliyun.com/composer/、https://mirrors.cloud.tencent.com/composer/、https://mirrors.huaweicloud.com/repository/php/。其余地址，包括 https://packagist.phpcomposer.com 已下线，https://packagist.laravel-china.org 同步不稳定，一律不要用。
