Composer遇到同名包直接中止安装并报“Package is already registered”错误，必须通过composer validate --strict或composer install -v定位重复name，唯一解法是修改fork包composer.json的name字段为全局唯一值并同步更新repositories和autoload映射。
Composer 遇到同名包（如两个 monolog/monolog）会直接中止安装，报 Package monolog/monolog is already registered —— 它不选、不合并、不提示“用哪个”，注册阶段就失败。
怎么快速确认是不是包名重复导致的错误
别靠猜，用命令定位真实冲突点：
- 运行
composer validate --strict：它会检查composer.json中所有name字段是否重复（包括require和repositories里的package类型定义） - 执行
composer install -v，盯住日志里是否出现skipping package X (already registered)或overwriting repository for X - 手动搜索：
grep -r '"name":' vendor/ | grep your-target，看vendor/下有没有其他包偷偷用了相同name - 重点检查
repositories数组——很多人把 fork 包写成vcs类型但忘了改name，这是最常见源头
改 fork 包的 name 是唯一稳定解法
临时删 vendor/ 或硬改 composer.lock 只能骗过一次，下次 update 就还原。真正合规的做法只有一条：
- 进 fork 包根目录，编辑其
composer.json，把"name": "vendor/package"改成带组织前缀的新值，例如"acme/monolog"或"myorg/laravel-debugbar" - 新
name必须全局唯一：不能只加下划线（如"monolog_custom"），避免未来和 Packagist 上公开包重名 - 打 tag 或推到新分支后，在主项目
composer.json的repositories中指向它，并在require中使用新name - 如果该 fork 包被其他依赖间接引用（比如
A → B → vendor/package），需在主项目中用replace显式声明替代关系，否则 Composer 仍会尝试装原包
replace 不等于自动加载，类找不到是另一回事
replace 只影响依赖解析阶段，它告诉 Composer “这个包我已提供，别再装了”。但它完全不触碰 autoload 配置：
- 如果你的 fork 包改了命名空间（比如从
Monolog\改成Acme\Monolog\），而主项目的autoload没同步映射新路径，运行时必报Class not found -
replace后必须检查 fork 包自身的autoload字段是否指向正确源码路径；若你没动命名空间，可保留原配置；若动了，就必须同步更新 - 别指望
replace自动重命名类或调整加载顺序——PHP 层面不允许同名类共存，autoload 机制也不支持类名别名
alias 不是包名别名，只是版本别名
很多人误以为 alias 能绕过包名冲突，其实它只对版本号起作用，且只在 repositories 的单个包定义中生效：
- 格式必须是
"version": "dev-main as 2.0.x-dev"，as前后要有空格，不能写成"alias": "new-name"（Composer 根本不认） - 别名版本号必须是合法约束（如
^2.0、dev-main），不能写latest或master - 加了 alias 后，
require里必须写对应版本约束，例如别名是"dev-main as 1.5.0"，就得写"vendor/name": "^1.5" - alias 不影响类文件位置或命名空间——它解决的是“版本解析冲突”，不是“包名注册冲突”
最容易被忽略的点：包名改了、replace 加了、alias 配了，但类还是加载不到——问题往往出在 autoload 映射没跟上，或者你试图用 Composer 解决 PHP 层面无法绕过的类重复声明问题。
