composer将包名（name字段）作为唯一键，同名即视为同一包，重复注册时解析器直接抛异常中止，不进入autoload或安装阶段；必须修改fork包的name字段或用replace声明替代关系并同步更新autoload映射。
Composer 遇到同名包（如两个不同来源都声明 monolog/monolog）会直接中止安装，报 Package monolog/monolog is already registered —— 它不合并、不覆盖、不提示“用哪个”，而是拒绝注册第二个。
为什么同名包一定冲突，不是“看谁先加载”？
Composer 内部用 name 字段作为包的唯一键，和 URL、Git 分支、版本号都无关。哪怕一个是 Packagist 上的官方包，另一个是你 fork 后改了代码但没改 name 的私有仓库，只要 name 相同，就视为同一包实体。重复注册时，解析器在内存里直接抛异常，根本不会走到 autoload 或安装阶段。
- 错误信息明确：终端会显示类似
Package vendor/name is already registered或is listed multiple times - 不是运行时问题，无法靠
autoload配置绕过 -
repositories类型（vcs/package/composer）不影响校验逻辑，只要name重复就卡住
怎么确认是不是同名包冲突？
别猜，用命令定位：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer validate --strict，它会检查composer.json中是否有重复name声明（包括require和repositories里的 package 定义） - 执行
composer install -v，观察日志里是否出现skipping package X (already registered)或overwriting repository for X - 手动打开
composer.json，搜索"name"和包名字符串，重点检查repositories数组里是否藏了一个同名的package类型定义
正确解法只有两种：改名 or 替换
临时删 vendor/ 或硬改 composer.lock 只能骗过一次，下次 update 就还原。真正稳定的做法只有：
- 对 fork 包：必须修改其
composer.json中的name字段，例如从"monolog/monolog"改为"acme/monolog"；同时同步更新其autoload映射（命名空间和路径要匹配新名） - 对主项目：若只想替换依赖链底层的某个包，用
replace显式声明替代关系，例如："replace": { "monolog/monolog": "2.10.0" }但注意：replace不自动加载你的代码，你仍需确保新包的类能被 autoloader 找到（比如通过psr-4正确映射）
最容易被忽略的点：replace 后类还是找不到
很多人加了 replace 就以为万事大吉，结果运行时报 Class not found。这是因为 replace 只影响依赖解析阶段，不触碰 autoload 配置。如果你的 fork 包改了命名空间或目录结构，而主项目的 autoload 没同步指向新路径，类就真的加载不到——这个环节完全独立于包名冲突本身，却常被当成“replace 失效”。
