Composer全局镜像配置不生效的三大硬性条件是：键名必须为repo.packagist（非repos或packagist.org）、type值必须显式写为"composer"、URL须为HTTPS且末尾带/；否则静默回退至官方源。
composer config -g repo.packagist 命令为什么总不生效
不是网络慢，而是命令写错三个硬性条件，Composer 就会静默 fallback 到 packagist.org，连警告都不给。
必须同时满足：
-
repo.packagist键名不能拼成repos.packagist（多一个 s）或packagist.org -
composer是必须显式写出的type值，不是可选参数，也不是注释 - URL 必须是 HTTPS，且末尾带
/：比如https://mirrors.aliyun.com/composer/✅，少斜杠会请求/packages.json导致 404
验证是否真写进去了，只看这一行输出：composer config -g repo.packagist
正确返回应为完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
返回空、null、或报 Key "repo.packagist" does not exist，说明根本没写成功。
项目级配置才是本地开发真正可靠的方案
你在终端配好全局镜像，但新开一个终端、用 IDE 内置终端、甚至切换 PHP 版本后，都可能失效——因为 ~/.composer/config.json 不一定被读到，尤其 phpstudy、XAMPP、phpbrew 等环境常绕过标准路径。
更稳的做法是进项目根目录（确保有 composer.json），执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会自动在 composer.json 顶层插入或更新 "repositories" 字段，key 固定为 "packagist"，不破坏已有私有源。
注意两个前提：
- 如果原
composer.json里是"repositories": []（数组），命令会直接报错；需先手动改成"repositories": {}（空对象）再重试 - 改完必须删掉
vendor/和composer.lock，再跑composer install（不是update）——否则旧 lock 文件仍按原始元数据地址下载
换源后还是卡在 Resolving dependencies？镜像不背这个锅
镜像只加速 Loading composer repositories 和 Downloading 阶段，对 Resolving dependencies 完全无影响。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
如果你发现卡在这一步，和镜像无关，典型原因有：
-
"php": "^7.4 || ^8.0"这类宽泛约束，让 Composer 尝试大量版本组合，解析极慢 -
require-dev里塞了太多调试工具（如phpunit/phpunit+mockery/mockery+behat/behat），大幅增加解空间 - 本地
composer.json里写了"packagist.org": false却没补镜像，导致基础包（如php、ext-json）根本无法校验
快速验证是不是镜像问题：加 -vvv 参数运行 composer install，搜日志里的 Downloading 行，域名是不是 mirrors.aliyun.com。不是？说明镜像根本没走；是？那瓶颈就在解析阶段，该收紧版本约束了。
临时切换镜像用于调试或 CI 脚本
不想动配置、又需要确认镜像是否真能用？用环境变量临时覆盖最干净：
COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install -vvv
这个方式不写任何文件，退出终端即失效，适合：
- CI 脚本中避免依赖全局配置（比如 GitHub Actions 的
runner用户没配过镜像） - 调试时快速对比官方源与镜像源行为差异
- 团队成员临时复现某人“本地快、CI 慢”的问题
注意：COMPOSER_REPO_PACKAGIST 只影响 packagist.org 这个默认源，不影响你自定义的私有源；它优先级高于全局配置，但低于项目级 repositories 配置。
最容易被忽略的一点：所有配置生效的前提，是 Composer 能正常发起 HTTPS 请求。如果 php -m | grep openssl 没输出，或者公司网络开了代理却没关 HTTP_PROXY，换十个镜像都没用——得先让 Composer “能说话”，再让它“说得快”。
