Composer安装时私有仓库优先于Packagist，需将私有源置于repositories数组首位，并显式添加{"packagist.org": false}禁用默认源，否则Packagist仍隐式兜底；类型须匹配（如Satis用"type": "composer"），且私有源packages.json必须包含目标包完整元数据。
Composer安装时如何让私有仓库优先于Packagist
Composer默认只认Packagist.org，要让它先查你的私有仓库（比如GitLab、Satis或Artifactory），关键不是“排序”，而是控制repositories数组的声明顺序和packagist.org的显式开关。Composer会按repositories数组从上到下依次查找包，遇到第一个匹配就停止。
- 在
composer.json中，把私有仓库放在repositories数组最前面 - 必须显式禁用默认Packagist，否则它永远在最后兜底：添加
{"packagist.org": false} - 私有仓库类型选
vcs（Git/SVN）、composer（Satis/Artifactory）或package（单包定义），不要混用类型导致解析失败
{
"repositories": [
{
"type": "composer",
"url": "https://your-satis.example.com"
},
{
"packagist.org": false
}
],
"require": {
"vendor/private-package": "^1.2"
}
}
为什么composer install还是去连Packagist
常见错误是以为只要加了私有源就自动生效，其实有三个隐性条件没满足：
-
composer.json里没写"packagist.org": false，Composer仍会 fallback 到官方源 - 私有仓库返回的
packages响应里不包含你require的包名+版本，Composer就跳过它继续往下找 - 用了
vcs类型但仓库URL没带.git后缀（如<a href="https://www.php.cn/link/be28ea7744231d35fc7fe61e26d12cc4">https://www.php.cn/link/be28ea7744231d35fc7fe61e26d12cc4</a>），Composer无法识别为有效VCS源，直接忽略该条目
运行composer diagnose能快速暴露这类配置问题；加-vvv参数执行composer install可看到具体尝试了哪些源、在哪一步匹配成功或失败。
多个私有仓库之间怎么控制优先级
Composer不支持权重或条件路由，只有严格的数组顺序。如果两个私有仓库都声明了同一个包（比如acme/utils），谁在repositories数组里靠前，谁就赢。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 把最稳定、最新版最全的仓库放第一位
- 避免在不同仓库里发布同名同版本包，否则行为不可预测（实际取决于网络响应快慢）
- 如果必须共存，建议用
composer类型统一代理多个后端（如Satis聚合多个Git仓库），而不是平铺多个vcs源
注意：repositories是项目级配置，不会影响全局；如果团队多人协作，记得把composer.json提交进Git，别只存在本地。
使用composer config动态修改仓库是否可行
composer config repositories.XYZ可以写入，但有两个硬限制：
- 它只能追加到
repositories末尾，无法插入到开头，所以不能用于提升优先级 - 写入的是
composer.json，但不会自动触发composer update --lock，锁文件仍沿用旧源信息，可能导致install失败或拉错版本
真正需要动态切源的场景（如CI中区分dev/staging/prod），推荐用环境变量+脚本生成临时composer.json，或者用COMPOSER_HOME指向不同配置目录，而不是依赖config命令。
私有仓库的HTTP状态码、响应头（尤其是Content-Type: application/json）、JSON结构合法性，任何一个环节出错都会让Composer静默跳过该源——这点最容易被忽略。
