Composer支持通过配置多个repositories实现私仓与Packagist共存，需显式添加{"type": "packagist", "url": "https://packagist.org"}并置于私仓之后，且私仓类型必须为"composer"；否则默认仓库被禁用，导致官方包无法安装。
Composer安装时怎么同时用多个仓库？
Composer本身不支持“合并多个仓库数据”这个操作——它只会从composer.json里定义的repositories列表中，按顺序查找包，找到第一个匹配的就停。所谓“合并”，其实是靠配置多个repository条目+合理设置类型和优先级来模拟的。
为什么packagist.org默认仓库不能被“合并”？
Composer把packagist.org当作隐式默认仓库（type: packagist），一旦你在repositories里显式声明了任何仓库（哪怕只是加了个type: "composer"），Composer就会**自动禁用默认仓库**。结果就是：没手动加回packagist，你就只能访问自己配的私仓，连monolog/monolog都装不上。
- 必须显式把官方源加回来：
{"type": "packagist", "url": "https://packagist.org"} - 顺序很重要：把私仓放前面，官方源放后面，才能实现“优先查私仓，缺的再走官方”
- 别写
"packagist.org"这种错误URL——正确地址是https://packagist.org（带协议）
composer install时如何让私仓和Packagist共存？
直接改composer.json的repositories字段，确保结构清晰、类型明确：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"repositories": [
{
"type": "composer",
"url": "https://your-private-repo.example.com"
},
{
"type": "packagist",
"url": "https://packagist.org"
}
],
"require": {
"vendor/private-package": "^1.0",
"monolog/monolog": "^2.10"
}
}
注意点：
- 私仓必须是
type: "composer"（不是vcs或package），否则无法索引整个包列表 - 如果私仓用了自签名证书，得在
config里加"secure-http": false（仅限内网） - 执行
composer install前，建议先跑composer clear-cache，避免旧缓存干扰仓库发现逻辑
为什么composer require有时只查私仓、不 fallback 到 Packagist？
常见原因是repositories里漏掉了packagist条目，或者顺序反了。另一个隐蔽坑是：某些私仓（比如Satis或Private Packagist）的packages JSON里没包含你require的包名，而Composer又没触发fallback——它只在“找不到包”时才往下查，但如果私仓返回了空packages响应（HTTP 200但JSON为空），Composer会认为“找到了但没这个包”，不再继续搜索。
- 验证方式：运行
composer show -p，看输出里是否列出packagist.org及其包数量 - 调试技巧：加
-vvv参数跑composer require xxx，观察日志里实际请求了哪些URL - 私仓服务端务必返回标准Composer API格式，尤其
packages字段不能缺失或为空数组
