RepositoryManager 初始化不依赖 config 的 repositories 字段，而是由 Composer 实例动态注入；项目级 repositories 配置仅在 loadRepositories() 阶段生效且彻底覆盖全局配置，该方法不合并仅替换，空数组 [] 也会触发覆盖导致无源可用。
RepositoryManager 初始化不依赖 config 里的 repositories 字段值，而是由 Composer 实例创建时动态注入；项目级 repositories 配置只在 RepositoryManager::loadRepositories() 阶段生效，且会彻底覆盖全局配置。
RepositoryManager 构造函数不读取配置项
很多人以为 RepositoryManager 实例化时会自动加载 composer.json 中的 repositories，其实不是。它的构造函数只接收 IOInterface 和 Config 对象，但此时 Config 里尚未解析出 repositories 数组 —— 这个字段要等到后续调用 loadRepositories() 才真正载入。
这意味着：
- 插件或自定义逻辑若在
PluginInterface::activate()里直接 new RepositoryManager，拿到的是空仓库列表 - 必须等
Composer::getRepositoryManager()被调用（通常在 install/update 命令执行中），才会触发loadRepositories() -
Config对象本身缓存了原始配置，但repositories键默认为 null，直到首次 load
loadRepositories() 如何裁决项目级 vs 全局仓库
真正决定仓库来源的，是 RepositoryManager::loadRepositories() 的执行逻辑。它不合并、不追加，只做一件事：如果项目 composer.json 里存在 "repositories" 字段（哪怕值是 []），就丢弃所有全局配置（包括 ~/.composer/config.json 里的 repositories）。
常见误判点：
-
"repositories": []→ 触发覆盖，结果是“无源可用”，报Could not find package -
"repositories": [{}]→ 合法空数组，仍会清空全局源，但至少不会因语法错误崩溃 - 全局配置里写了私有源，项目里只配了镜像，结果私有源完全不可见 —— 不是因为顺序问题，是因为根本没加载
addRepositoryClass() 不影响初始化流程
注册自定义仓库类型（如 RepositoryManager::addRepositoryClass('vcs', MyVcsDriver::class)）发生在插件激活阶段，但它只是往静态映射表里塞一个类名，和 RepositoryManager 实例的初始化无关。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
真正起作用的时机是：loadRepositories() 遍历配置数组，对每个仓库对象调用 RepositoryFactory::createRepository()，再根据 type 字段查表找到对应 driver 类。
注意：
-
type必须是字符串字面量，比如"vcs"、"composer"，不能是变量或拼接结果 - 即使你注册了
'nas'类型，但配置里写"type": "vcs"，依然走默认 VCS driver - driver 类的
supports()方法只在 create 时调用，用于校验 URL 是否匹配，不影响初始化顺序
packagist.org: false 是运行时哨兵，不是配置开关
这个键值对既不参与 RepositoryManager 构造，也不在 loadRepositories() 初期被识别。它只在遍历仓库数组过程中，当遇到 {"packagist.org": false} 这个独立对象时，才由 RepositoryFactory 拦截并设置内部标志位 $this->disablePackagistFallback = true。
关键约束：
- 必须是数组中的一个独立元素，不能嵌套在其他仓库定义里
- 位置必须在私有源之后、数组末尾；放在前面会导致私有源根本没机会被检查
- 它不删除 Packagist 源，只是关掉“兜底请求”行为 —— 即使后面还跟着
{"type":"composer","url":"https://packagist.org/"}，也不会被跳过
最易被忽略的一点：RepositoryManager 初始化本身几乎不抛错，所有“找不到包”的问题都发生在后续的 resolve / download 阶段。调试时别盯着构造函数看，要抓 RepositoryManager::getRepositories() 返回值，再确认 loadRepositories() 是否真被调用过。
