必须精准配置composer.json顶层repositories数组，每项显式声明type（packagist/composer/vcs/package）和url，否则composer静默忽略私有源或报错找不到包。
要在项目中正确加载私有包或替换官方源，必须精准配置composer.json中的repositories字段，否则Composer会直接跳过你的私有仓库、报错找不到包，甚至静默使用错误版本。
repositories字段的基本结构与生效前提
repositories必须是composer.json顶层的JSON数组，不能嵌套在config、scripts或其他字段下；它不是可选开关，而是包发现的唯一入口列表。
每项仓库对象必须显式声明type和url两个键，缺一不可——漏写"type": "vcs"会导致整个条目被Composer完全忽略，且不报任何警告。
【type值只能是packagist、composer、vcs、package之一，写成git、svn或留空均无效】
四种type类型的实际行为差异
type决定Composer如何查找和解析包，不同type走完全不同的元数据获取路径：
方法一：type为"composer"
适用于Satis、Private Packagist、Artifactory等兼容Packagist协议的私有源。URL必须指向一个能返回packages.json的HTTP服务，例如https://repo.example.com；该文件必须包含合法的JSON格式索引，且响应头Content-Type需为application/json。
方法二：type为"vcs"
对应Git、SVN、HG等版本控制系统仓库，如https://gitlab.example.com/acme/utils.git。Composer不会扫描整个仓库，只在require中明确写出该仓库内composer.json里定义的完整name（如acme/utils）时，才去该URL执行git clone并读取其composer.json。
方法三：type为"package"
用于单个离线包注入，适合临时测试或无法托管VCS的场景。需手动写出完整包信息，包括name、version、dist、source等字段，且version必须是稳定版本标识（如1.0.0），不能写dev-main。
方法四：type为"packagist"
仅支持一种写法：{"type": "packagist", "url": "https://packagist.org"}。它不是默认开启的“后备选项”，而是显式启用官方源的唯一方式；一旦你定义了任意repositories数组，Packagist.org就自动失效，必须手动加回这一项，否则monolog/monolog这类通用包将无法安装。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
多个仓库的匹配顺序与陷阱规避
第一步：明确顺序即优先级
Composer严格按repositories数组从上到下的顺序逐个检查，找到第一个匹配name和版本约束的包就立即停止，后续仓库完全不参与本次解析。
第二步：避免隐式丢弃官方源
如果你只写了私有仓库，却没把Packagist.org显式加回来，那么所有非私有包都会报Could not find package——这不是网络问题，是配置逻辑缺失。
第三步：vcs仓库不参与全局搜索
vcs类型仓库永远不会作为fallback源。比如你在repositories里加了GitLab地址，但require写的是"vendor/missing"，而该仓库实际包名是"acme/utils"，Composer连尝试都不会尝试，直接报错。
第四步：同名包以靠前仓库为准
若两个vcs仓库都含acme/utils，且require中指定了该名，Composer只用第一个url，第二个彻底无效；即使第一个返回404或无composer.json，也不会继续查第二个。
这一步操作起来很简单，直接把packagist.org条目放在数组末尾即可，但放错位置会导致私有包永远不被命中。
认证失败的典型原因与定位方式
当使用HTTPS方式访问私有Git仓库却收到401或403错误，问题几乎一定出在认证未透传——Composer不会复用git credential或~/.netrc中的凭据。
必须单独配置auth.json，且域名必须与repositories中url的host部分完全一致（比如url是https://gitlab.example.com，则auth.json中key必须是"gitlab.example.com"）。
【SSH方式更可靠：url写成git@gitlab.example.com:acme/utils.git，依赖系统SSH agent，无需额外配auth.json】
