Composer镜像配置不生效的主因是repo.packagist键名错误、缺"type": "composer"字段或URL末尾无斜杠，任一出错均导致Composer静默回退至packagist.org；验证需执行composer config -g repo.packagist输出完整JSON且含正确URL。
composer config -g repo.packagist 为什么总不生效
命令跑完没报错，但 composer install 还卡在 Loading composer repositories，大概率是三个硬性条件漏掉一个：repo.packagist 键名写成 repos.packagist（多一个 s）、漏掉中间的 composer type 值、URL 末尾没加 /。这三处任一出错，Composer 2.x 都会静默 fallback 到官方源，不提示也不报错。
验证是否真写进去了，直接运行：composer config -g repo.packagist。输出必须是完整 JSON 对象，形如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。返回空、null、报 Key "repo.packagist" does not exist，说明根本没写成功。
-
repo.packagist是固定键名，不能是packagist.org或repositories.packagist -
composer是必须显式写出的 type 值，不是注释，也不是可选项 - URL 必须用 HTTPS，且末尾带
/：比如https://mirrors.aliyun.com/composer/✅，少斜杠就会拼出/composerpackages.json导致 404
项目级配置比全局更可靠
你在终端用 root 或自己的用户配了全局镜像，但宝塔后台用 www 用户跑命令、GitHub Actions 用 runner 用户、Docker 构建里甚至没有 ~/.composer 目录——这些场景下，-g 配的全是“空气”。
进项目根目录（确保有 composer.json），执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不加 -g）。它会自动往 composer.json 的 repositories 字段安全追加，key 固定为 "packagist"，不会覆盖已有私有源。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 如果
composer.json原先是"repositories": []（数组），命令会报错；需先手动改成"repositories": {}（空对象）再重试 - 千万别手写
"packagist.org": false—— 这会彻底关掉基础包校验，连php或ext-json都装不上 - 改完必须删掉
vendor/和composer.lock，再跑composer install（不是update），否则旧 lock 文件里的 hash 和镜像元数据不匹配
换源后还是卡在 Resolving dependencies？镜像不背这个锅
镜像只加速下载阶段（Downloading），对依赖解析过程完全无影响。如果你发现卡在 Resolving dependencies，和网络、镜像都无关，典型诱因有：
-
"php": "^7.4 || ^8.0"这类宽泛版本约束，会让 Composer 尝试大量组合，拖慢解析 -
require-dev里塞了太多未锁定版本的工具链，比如"phpunit/phpunit": "^10.0" - 用了大量
dev-main或dev-develop分支依赖
这类问题换任何镜像都无效，得收紧约束、锁定版本、精简 require-dev。
临时验证某个镜像是否可用，不用动配置
不想改任何配置，又想快速试一个镜像是否通？加 --repository-url 参数：composer install --repository-url=https://mirrors.aliyun.com/composer/。它优先级最高，会覆盖全局和项目级配置，适合排查或 CI 临时调试。
但要注意：这种用法只对当次命令生效，不会写入任何配置文件。真正要长期用，还是得走 composer config 写入，且必须严格满足那三个硬性条件——少一个，就等于没配。
