镜像配置本身不触发冲突，但与repositories数组共存时会因覆盖逻辑失效、顺序错位或隐式兜底未关闭导致包找不到或约束被绕过；二者互斥，只要composer.json含repositories字段（含空数组），全局镜像即被彻底丢弃。
镜像配置本身不会触发冲突，但和 repositories 配置叠加时会因覆盖逻辑失效、顺序错位或隐式兜底未关闭，导致包找不到或约束被绕过——问题不在镜像，而在配置层级关系没理清。
composer config repo.packagist 和 repositories 数组不能共存
全局或项目级执行 composer config repo.packagist https://mirrors.aliyun.com/composer/ 会写入一个名为 packagist.org 的仓库别名，但它**和 composer.json 里的 repositories 数组互斥**：
- 只要项目
composer.json中存在"repositories"字段（哪怕空数组"repositories": []），全局配置的镜像就会被彻底丢弃，不是合并，不是追加 - 反过来，如果用了
repositories数组定义私有源，又没显式禁用packagist.org，Composer 仍会隐式兜底查官方源，可能拉到旧元数据或冲突版本 - 常见错误：在
repositories里写了私有源，又单独跑composer config repo.packagist，结果发现私有包还是找不到——因为后者根本没生效
私有源 + 镜像加速必须设 type: "composer"
手动添加的私有仓库若漏写 "type": "composer"，Composer 会 fallback 到 VCS 模式（Git/Svn），跳过镜像代理，还可能误判版本格式，导致 dev-main 被当成分支而非包源：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 正确写法：
{"type": "composer", "url": "https://my-company.example.com"} - 错误写法：
{"url": "https://my-company.example.com"}（缺 type）或{"type": "vcs", "url": "..."}（类型错） - 验证方式：运行
composer diagnose，看输出里是否提示Repo packagist.org is not a Composer repository类似警告 - 小众镜像源若裁剪了
conflict或require-dev字段，会导致composer why-not判断失真，优先选阿里云或官方推荐镜像
packagist.org: false 必须是独立对象且放在私有源之后
{"packagist.org": false} 不是开关，而是 repositories 数组里的“终止符”，位置错了就等于没关：
- 必须作为独立对象存在，不能嵌套进其他仓库定义里，比如
{"type":"composer","url":"...","packagist.org":false}无效 - 键名必须严格为
"packagist.org"，写成"packagist"或"packagist.com"都不识别 - 必须放在所有私有源之后、数组末尾；如果放前面，Composer 查完私有源立刻碰到它，直接报
Could not find package退出 - 禁用后如还需公共包，得手动加回官方源，并确保排在它之后：
{"type": "composer", "url": "https://packagist.org/"}
切换镜像后构建失败，大概率是元数据同步差异暴露了真实约束
换镜像不是修复手段，而是探测器——它让 Composer 更快拿到最新 composer.json 元数据，从而提前暴露你长期忽略的冲突：
- CI 构建失败 ≠ 镜像有问题，而是本地开发环境缓存了旧约束（比如某包刚发 v3.0 并更新了
conflict字段） - 执行前务必
composer clear-cache，否则本地缓存污染判断，尤其在切换镜像后 - 如果
composer why-not输出为空，不是镜像问题，检查是否拼错包名、版本号格式错误（如写成^3而非^3.0），或根本没在composer.json里声明该包 - 镜像再快也解决不了三类硬冲突：PHP 平台约束不匹配、
conflict字段显式禁止、dev-main引入未测 commit —— 这些必须人工干预
真正容易被忽略的是：所有配置层级（全局 config、项目 config、composer.json）之间没有“继承”或“合并”，只有“整块替换”。你以为在叠加，其实是在互相擦除。
