私有仓库必须置于 repositories 数组首位，否则 Composer 会短路匹配导致私有包无法安装或被公共源高版本覆盖；需显式添加 {"packagist.org": false} 禁用官方源，并删除 composer.lock 和 vendor 后重新 install。
当你在项目中同时配置了私有仓库、国内镜像和 Packagist 官方源，却遇到 composer install 拉不到私有包、或意外装上了公共源的高版本同名包，问题往往不出在包本身，而在于 repositories 数组里仓库的书写顺序——Composer 会严格按此顺序发起元数据请求，命中即止，后续全跳过。
仓库匹配是硬性短路，不是 fallback
第一步：打开项目根目录下的 composer.json，定位到 repositories 字段。
第二步：确认数组中每个仓库对象的排列顺序——Composer 从索引 0 开始逐个发起 HTTP GET 请求，检查该仓库是否返回 HTTP 200 状态码且响应体中包含目标包的元数据（如 packages.json 中有对应 vendor/name 条目）。
第三步：一旦某个仓库返回有效元数据，Composer 立即锁定该源，不再向后续任何仓库发起请求。哪怕你把阿里云镜像写在第一位，但私有包只存在于第四个仓库，它就根本不会被查到。
这一步没有“重试”或“兜底”逻辑。DNS 失败、连接超时、502 错误都会直接报错退出；只有明确的 HTTP 404 才会继续查下一个源。
私有仓库必须置于最前
方法一：显式声明私有 Composer 仓库（type: "composer"）
将私有源配置为 repositories 数组的第一个元素，URL 必须以 / 结尾，例如 "https://packages.your-company.com/"。若末尾遗漏斜杠，请求会变成 https://packages.your-company.compackages.json，返回 404，Composer 就立刻切到下一个源——你以为配了私有源，其实它一次都没被真正访问过。
方法二：使用 VCS 类型仓库（type: "vcs"）
适用于 Git 地址直连场景，如 {"type": "vcs", "url": "https://git.your-company.com/internal/monolog"}。注意：VCS 源不参与全局元数据匹配，仅对 composer require vendor/name 显式调用生效，因此它不会抢占镜像位置，但也无法覆盖 laravel/framework 这类被其他依赖间接拉入的基础包。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
【私有源必须放在数组首位，否则同名包会被公共镜像中的高版本覆盖】
必须显式禁用 packagist.org 才能让镜像真正生效
默认情况下，Composer 总会把 https://packagist.org 当作隐式兜底源——哪怕你把阿里云镜像写在第一位，只要它对某个新包返回 404（比如尚未同步），Composer 就立刻切回官方源，看起来像“镜像没起作用”。
正确做法是在 repositories 数组末尾添加一个独立对象：{"packagist.org": false}。这个对象必须是数组里的一个单独元素，不能嵌套在其他对象里，键名必须精确为 packagist.org（不是 packagist 或 packagist.com）。
执行 composer config repositories 验证是否生效：输出中不应出现 https://repo.packagist.org，且应明确看到 "packagist.org": false。
配置生效前，必须删除 composer.lock 和 vendor/ 目录，否则旧锁文件仍会沿用历史解析路径。
验证当前真实生效顺序
运行 composer config repositories，查看终端输出的 JSON 数组。
别依赖注释、IDE 提示或记忆——这是唯一能反映 Composer 实际行为的权威依据。
如果输出里还存在 "url": "https://repo.packagist.org"，说明 {"packagist.org": false} 没有被正确添加，或者被写在了错误的位置（比如嵌套在另一个仓库对象内部）。
这一步操作起来很简单，直接在终端敲命令就行。
