Composer仓库优先级由repositories数组顺序与"packagist": false共同决定：未禁用时官方源兜底、顺序无效；禁用后严格按数组从上到下匹配，首个返回元数据的仓库生效，后续忽略。
Composer 仓库优先级不是靠“设开关”或“调参数”实现的，而是由 repositories 数组顺序 + "packagist": false 配置共同决定的——不关掉默认源，私有包再靠前也白搭；顺序写错，第一个命中的仓库就锁死结果。
为什么私有包始终没被安装，反而拉了 packagist.org 的官方版？
根本原因是 packagist.org 默认隐式启用，且排在所有显式仓库之后。即使你把私有仓库写在 repositories 第一位，Composer 仍会先查 packagist.org（只要它没被禁用），而 packagist.org 一旦返回了同名包的元数据，就直接跳过你的私有源。
- 必须在
repositories数组中加入{"packagist": false}来禁用默认源——注意它不是仓库，不能放最前面，得放在私有源之后 - 私有源类型为
vcs时，只对require中显式声明的包生效，不会参与全局元数据合并；想覆盖laravel/framework这类基础包，得用type: "composer"并确保其packages.json明确列出了该包 -
composer config -g repos.packagist false是全局禁用，会破坏其他项目，别用
如何让阿里云镜像和私有仓库共存且各司其职？
镜像（如 https://mirrors.aliyun.com/composer/）只是 packagist.org 的只读代理，不托管私有包；它和私有源不是“并列候选”，而是“分工协作”关系——私有源负责特定包，镜像兜底其余公开包。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 正确顺序：
repositories数组里，私有源（type: "composer"）放最前 → 镜像源（type: "composer"）放最后 →{"packagist": false}放数组末尾 - 千万别同时写
"https://packagist.org"和镜像地址，否则 Composer 会优先连原站，断网即失败，镜像根本不会触发 - 验证是否生效：运行
composer config repositories，确认输出中包含你的私有 URL，且"packagist": false存在；再跑composer update -vvv vendor/package看日志里实际请求了哪个源
为什么改了 repositories 顺序，composer require 还是装错了版本？
因为 Composer 查找是「命中即停」，不是「比对全部再选最优」。只要第一个仓库返回了满足约束的版本，哪怕它更旧、更不稳定，后续仓库里的 dev-main 或 2.1.0@beta 都不会被考虑。
-
prefer-stable不影响优先级逻辑，它只在多个候选版本都满足minimum-stability时起排序作用；单独设它没用，必须配"minimum-stability": "stable" - VCS 类型仓库（如 Git 地址）不生成全局
packages.json，所以无法被用于“匹配查找”，只响应显式require "vendor/pkg": "dev-branch"这种写法 - package 类型仓库必须手动写全
version、dist字段，否则composer install会跳过该条目
最容易被忽略的一点：仓库顺序只对「已声明支持该包」的源生效。如果你的私有 Composer 源 packages.json 里没列出 monolog/monolog，哪怕它排第一，Composer 也会直接跳过，去下一个源查——它不猜，也不 fallback，只按明确声明的内容执行。
