Composer config -g repo.packagist 不生效是因为未同时满足四个硬性条件：键名必须为 repo.packagist（非 repos.packagist 等）、中间必须显式指定 type 值 composer、URL 必须 HTTPS 且末尾带 /、必须加 -g 参数；任一缺失即静默回退官方源，且验证需输出完整 JSON 对象。
配了镜像却还是连 packagist.org，不是网络问题，是配置被 Composer 静默忽略——它不报错，只当没这回事。
为什么 composer config -g repo.packagist 总是不生效
这条命令必须同时满足四个硬性条件，漏一个就回退到官方源，且无任何提示：
-
repo.packagist键名不能写成repos.packagist、packagist或packagist.org - 中间的
composer是 type 值，不是可选参数：写成composer config -g repo.packagist https://mirrors.aliyun.com/composer/就失效 - URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（会拼出/composerpackages.json导致 404） - 必须用
-g参数；不加就是改当前项目，不是全局
验证是否真写进去了，只看这一行输出：composer config -g repo.packagist。返回 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 才算成功；空、null、或报 Key does not exist，说明根本没写对。
项目级 repositories 字段一出现就屏蔽全局镜像
只要 composer.json 顶层有 "repositories" 字段（哪怕只是 "repositories": []），全局配置立刻失效——不是“优先级低”，而是直接跳过。
- CI 流水线脚本自动生成空数组
"repositories": []，构建时就会直连packagist.org -
composer create-project拉的模板常自带repositories，你刚配好的全局镜像压根没机会触发 - 执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g）会全量覆盖整个repositories字段，把你原有的私有 Git 源清空
安全做法是手动编辑 composer.json，确保 "repositories" 是数组，首位放 {"packagist.org": false}，第二位才是镜像源，其他自定义源保留在同一数组里。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{"packagist.org": false} 必须独立、靠前、拼写精确
这不是可选项，而是硬性兜底规则：没有它，Composer 会在查完所有镜像后自动追加官方源——在国内基本等于卡死。
- 必须是
repositories数组里的一个独立对象，不能塞进别的对象里（比如不能写在某个私有源对象内部） - 必须放在数组第一个位置；靠后会被后续条目影响语义（Composer 解析顺序依赖位置）
- 键名必须是
"packagist.org"，写成"packagist"、"packagist.com"或"packagist.org": true都无效 - 值必须是布尔
false，不是null、字符串"false"或数字0
漏掉这个，哪怕镜像 URL 完全正确，也会在查完阿里云后继续去 packagist.org 转一圈，而那一圈大概率超时或 502，直接报错。
换镜像后 composer install 报 hash 不匹配
这不是网络或镜像问题，是旧 composer.lock 里记录的包哈希和 dist URL 来自官方源，切换镜像后路径映射不同，校验必然失败。
- 必须删掉
vendor/目录 - 必须删掉
composer.lock文件 - 再运行
composer install（不是update），让 Composer 重新解析依赖、生成新 lock 文件
很多人只清缓存、不删 lock，结果反复失败——因为 lock 文件是权威来源，Composer 不会为镜像差异做适配，只认它写的 URL 和 hash。
