Composer镜像配置失效主因是键名错（应为repo.packagist单数）、缺type值“composer”、URL末尾无/，三者任一出错均静默回退官方源；项目级repositories字段会完全屏蔽全局配置；换源后必须清缓存并重生成composer.lock。
Composer 镜像不是“配了就快”，而是“配错就静默回退到 packagist.org”——90% 的卡顿、404、hash 不一致，都源于配置没写对或没清干净。
composer config -g repo.packagist 命令为什么总不生效
它根本没写进去，但 Composer 不报错，只默默 fallback。常见硬伤有三个：
- 键名写成
repos.packagist（多一个s）或packagist（漏repo.前缀），Composer 2.x 完全忽略 - 中间漏掉
composer这个type值，比如写成composer config -g repo.packagist https://...，命令看似成功，实际存的是无效结构 -
url少了末尾斜杠，例如https://mirrors.aliyun.com/composer→ 请求会拼成https://mirrors.aliyun.com/composer/packages.json，返回 404 后立即切回官方源
验证是否真写入：运行 composer config -g repo.packagist，输出必须是完整 JSON，形如 {"type":"composer","url":"https://mirrors.aliyun.com/composer/"}。空、null、报错或只返回 URL 字符串，都说明失败。
项目级 repositories 数组必须首项为 {"packagist.org": false}
Composer 2.2+ 把 packagist.org 当作硬编码权威源，光加镜像 URL 不管用。不显式禁用，镜像 404 或超时后仍会 fallback，导致部分包走镜像、部分走官方源，行为不可预测。
-
"repositories"必须是数组[]，不能是对象{}，否则整个字段被忽略 - 第一项必须是独立的
{"packagist.org": false}，不能合并进第二项（如{"packagist.org": false, "type": "composer", "url": "..."}是无效的） - 第二项起才是镜像源，
url值必须以/结尾，否则路径拼接错误
改完 composer.json 后，必须删掉 vendor/ 和 composer.lock —— 因为 composer.lock 里记录的是旧源下的完整 dist URL（如 https://api.github.com/.../zipball/），Composer 安装时优先读 lock 文件，完全不查新 repositories。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
全局镜像被项目级配置覆盖却没察觉
Composer 镜像源优先级是：项目级 composer.json 中的 repositories > 全局配置 > 默认源。只要项目根目录存在 composer.json 且含 "repositories": []（哪怕空数组），全局设置就彻底失效。
- 验证当前生效的是哪个：进项目目录后运行
composer config repo.packagist；若提示Key "repo.packagist" does not exist，说明项目里用了数组形式的repositories，得看整个repositories字段内容 - CI/CD 环境尤其危险：用
sudo composer config -g很可能写进了root用户的~/.composer/config.json，但构建实际以www或runner用户运行，根本读不到 - 团队协作建议统一执行
composer config --global --unset repo.packagist，清空所有成员的全局镜像，强制走项目级声明，避免混用
真正生效的标志不是 composer install 变快，而是 composer install -vvv 日志里出现 Downloading https://mirrors.aliyun.com/composer/packages.json —— 其他任何现象都不算数。
私有 VCS 源和镜像共存时怎么不丢包
私有 GitLab/GitHub 仓库（"type": "vcs"）和 repo.packagist 互不影响，但手动编辑 composer.json 极易出错：漏方括号、引号不全、误删已有源。
- 正确做法是让 Composer 自动合并：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），它会自动处理repositories字段格式 - 如果原本是
"repositories": {}，命令会转为标准数组并追加；如果原本是"repositories": [ ... ]，命令会向数组末尾插入新项，不破坏私有源 - 千万别在
repositories里写"packagist": false—— 这会导致基础包（如php、ext-json）校验失败
最常被忽略的一点：改完配置后，composer update --lock 必须跑一次，否则 composer.lock 仍指向旧源地址，下次 CI 构建还是走官方源下载。
