Composer多源仓库通过repositories配置多个包来源，按数组顺序查找，仅对Packagist未注册或版本约束明确指向某源的包生效；需正确设置type（如vcs、package），避免误加packagist.org，私有源需配合@dev后缀或指定分支强制命中。
什么是 Composer 多源仓库（repositories）
Composer 默认只从 packagist.org 拉包，但实际项目中常需混用私有 Git 仓库、本地路径、VCS 分支或镜像源。所谓“多源”，就是通过 repositories 配置显式声明多个来源，让 composer install 或 require 能按优先级或包名匹配去不同地方找包。
如何在 composer.json 中配置多个仓库
关键不是堆叠一堆源，而是控制它们的生效范围和优先级。Composer 按 repositories 数组顺序查找，但只对「未在 Packagist 上注册」或「版本约束明确指向某源」的包起作用。常见误操作是把私有包写成 "vendor/name": "^1.0" 却没配 type: "vcs"，结果仍去 Packagist 找——它根本找不到。
-
type: "vcs"用于 Git/SVN 仓库，必须提供可 clone 的 URL（如https://gitlab.example.com/myorg/mylib.git），Composer 会自动探测composer.json -
type: "package"用于手动定义单个包（比如你维护一个没托管到 Git 的 ZIP 库），需完整写出name、version、dist或source - 不要把
packagist.org加进repositories—— 它默认启用；加了反而可能因顺序问题屏蔽掉私有源 - 私有 Git 仓库若含敏感 token，用
https://token:x-oauth-basic@github.com/...方式嵌入 URL，或提前配置auth.json
为什么 composer require 有时不走你配的私有源
因为 Composer 默认信任 Packagist 的元数据缓存。即使你已配好 vcs 源，执行 composer require myorg/mylib 时，它仍先查 Packagist，发现无此包才 fallback 到你的源——但如果该包名恰好被别人占用了（哪怕没发布），就会报 Could not find package myorg/mylib。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 强制走私有源：加
@dev后缀，如composer require myorg/mylib:@dev，触发 VCS 探测 - 更稳的方式：先运行
composer clear-cache，再执行composer require myorg/mylib:dev-main（指定分支） - 检查是否生效：运行
composer show -p，看输出里是否有你的私有包及其 source 类型 - 如果用的是 GitHub/GitLab 私有仓库，确保
composer.json在仓库根目录，且分支名（如main）与你在require中写的版本约束一致
镜像源 + 私有源共存时的坑
国内常用 https://packagist.phpcomposer.com 或 https://mirrors.aliyun.com/composer/ 做全局镜像，但这仅加速 Packagist 官方包。它不会代理你的私有 vcs 源——也就是说，镜像配置和 repositories 是两套逻辑，互不干扰。
- 镜像只影响
packagist.org的请求，不影响你配的type: "vcs"或type: "package" - 如果你在
repositories里错误地写了{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，会导致所有包都只从镜像拉，私有包彻底失效 - 想让私有源也走内网加速？只能自己搭 Satis 或 Private Packagist，不能靠公共镜像
真正容易被忽略的是：私有包的依赖树里如果包含 Packagist 上的包，Composer 会自动切回默认源下载——这个切换完全静默，不需要你额外配置，但排查网络超时时得意识到它可能跨了两个通道。
