packagist.org 默认被强制设为最低优先级；需通过顶层配置 "packagist": false 禁用默认源，再手动将其作为普通仓库按序声明，才能实现私有仓库优先。
packagist.org 被自动降级为最低优先级？
默认情况下，Composer 并不按配置顺序“逐个尝试”仓库，而是把 packagist.org 当作兜底源——哪怕你把它写在 repositories 数组最前面，只要没显式禁用默认源，它就会被 Composer 自动移到最后。这是很多人的第一处困惑来源。
真正起作用的是 packagist 配置项的开关逻辑：
- 设
"packagist": false→ 彻底禁用官方源，所有包都必须由你定义的仓库提供 - 设
"packagist.org": {"type": "composer", "url": "https://packagist.org"}→ 手动声明为普通仓库，此时顺序才生效 - 不写
packagist配置 → 默认启用，且强制最低优先级
如何让私有仓库优先于 packagist.org？
关键不是“提高私有源优先级”，而是“移除 packagist.org 的默认特权”。最稳妥的做法是：显式关闭默认源 + 手动注册 packagist.org 为普通仓库。
在 composer.json 中这样写：
{
"repositories": [
{
"type": "composer",
"url": "https://your-private-repo.example.com"
},
{
"type": "composer",
"url": "https://packagist.org"
}
],
"packagist": false
}
注意两点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"packagist": false必须顶层配置，不能放在repositories里 - 私有仓库必须放在
packagist.org条目之前，顺序才有效 - 如果私有仓库返回 404（包不存在），Composer 才会继续查下一个，不会跳过
使用 artifact 或 package 类型仓库时的优先级陷阱
当仓库类型是 "type": "artifact" 或 "type": "package"，它们不支持动态包发现，只提供固定 JSON 文件或预打包 ZIP。这类仓库的优先级规则不同：
- 它们**不参与版本匹配竞争**：Composer 先查所有“可搜索型”仓库（如
composer类型）找包名和版本元数据，再从artifact/package中拉取具体 ZIP - 如果你同时配置了私有
composer源和artifact源，且两者都含同名包，composer类型的元数据仍起决定性作用 -
artifact仓库无法覆盖packagist.org上已存在的包名，除非你关掉默认源
全局配置 vs 项目配置的优先级谁更大？
全局 config.json（通常在 ~/.composer/config.json）里的 repositories **完全不生效**，Composer 从不读取全局仓库配置。所有仓库设置必须写在项目级 composer.json 中。
但有一个例外：全局 auth.json 里的凭证会影响所有仓库的认证请求；而 config.json 中的 github-oauth 或 http-basic 配置也仅用于认证，不改变仓库顺序或可用性。
所以别费劲往全局配仓库——它根本不会被加载。
复杂点在于：一旦你禁用了 packagist，又没手动补上 packagist.org，连 monolog/monolog 这种基础包都会安装失败，报错是 Could not find package xxx at any version，而不是网络错误。这个提示容易让人误判成私有源挂了，其实只是漏掉了兜底源。
