答案是三个硬性条件缺一不可：键名必须为repo.packagist（单数）、type值必须显式写composer、url须https且以/结尾；任一缺失均静默回退官方源且不报错。
composer config -g repo.packagist 命令为什么总不生效
它不报错，但下载还是卡在 Downloading，90% 是因为三个硬性条件漏掉一个：repo.packagist 写成 repos.packagist（多一个 s 就静默忽略）；第二个参数漏掉 composer（这是必需的 type 声明，不是可选注释）；URL 末尾没加 /，比如 https://mirrors.aliyun.com/composer ❌，必须是 https://mirrors.aliyun.com/composer/ ✅。
验证是否真写进去了：运行 composer config -g repo.packagist。输出必须是完整 JSON 对象（如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}）或至少是那个带斜杠的 URL 字符串。如果为空、null、或仍是 https://packagist.org，说明根本没写成功。
- Windows 用户手动改过
C:\Users\用户名\AppData\Roaming\Composer\config.json？格式错误或权限不足会导致配置被忽略 - Mac/Linux 下执行命令前确认当前用户是谁——
whoami，别用sudo写了 root 的配置，结果 PHP 进程跑在www-data下根本读不到 - 新版 Composer 有时只返回 URL 字符串，只要不是空或官方地址，就算对
CI/Docker/宝塔里镜像为啥还是走官方源
全局配置 composer config -g 写的是当前用户的 ~/.composer/config.json，而 CI 流水线用 runner 用户、宝塔默认用 www 用户、Docker 容器里可能是 www-data 或自定义非 root 用户——它们都读不到你本地账户下的配置。
排查方法：在对应环境里先切到实际执行用户，再运行 composer config -g repo.packagist。例如宝塔里：sudo -u www composer config -g repo.packagist；CI 脚本里别依赖全局配置，改用临时参数：composer install -vvv --repository=https://mirrors.aliyun.com/composer/。
- Dockerfile 里统一用
RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，确保所有用户可见 - ECS 或内网环境务必换内网地址：
http://mirrors.cloud.aliyuncs.com/composer/（注意是http，非https） - GitHub Actions 或 GitLab Runner 上加
COMPOSER_IPV4=1环境变量，绕过 IPv6 探测卡顿
换镜像后仍卡在 Resolving dependencies 怎么办
镜像只加速「元数据拉取」和「ZIP 包下载」，不参与依赖解析。如果你发现 composer update 卡在 Resolving dependencies 几十秒甚至几分钟，和镜像无关，问题大概率出在：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer.json里 PHP 版本约束太宽，比如"php": "^7.4 || ^8.0 || ^8.1"，让 Composer 尝试大量组合 - 存在未锁定的
dev-分支依赖，如"monolog/monolog": "dev-main" -
"ext-swoole": "*"只是声明“我需要这个扩展已启用”，不是安装指令——镜像再快，也救不了没装好的swoole扩展
运行 php -m | grep swoole 没输出？那 composer install 再快 1 秒，运行时照样报 Class 'Swoole\Http\Server' not found。
阿里云/华为云镜像怎么选、怎么设才稳
2024 年起实测有效的只有两个：阿里云和华为云。清华源已关闭公共 Composer 镜像服务；腾讯云镜像同步延迟高、偶尔 503；PHPComponer 镜像早已下线。别搜到旧教程就照抄。
全局设置（推荐）：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/；华为云备选：composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/。设完立刻生效，不用重启终端。
- 公司内网或 CI 环境里，先
curl -I https://mirrors.aliyun.com/composer/packages.json测试是否返回 200；若提示 SSL certificate problem，升级系统根证书库：sudo update-ca-certificates（Debian/Ubuntu）或sudo yum update ca-certificates（CentOS/RHEL） - CI 中建议显式指定镜像 + 关闭 TLS 验证（仅限可信内网）：
composer config -g secure-http false，再设镜像 - 千万别用
http://明文源——多数新版 Composer 直接拒绝加载
镜像只管“下载”，不管“加载”。Swoole 相关包（如 swoole/ide-helper、easyswoole/easyswoole）体积大、dev 依赖多，直连 packagist.org 常卡 20 秒以上；但哪怕下载快了 5 倍，ext-swoole 没装好，一切白搭。
