composer不会消除类名冲突，只按配置加载文件；冲突时php直接fatal error。应运行composer dump-autoload -o --verbose定位重复类路径，检查autoload_psr4.php和autoload_classmap.php映射重叠，fork包须改name字段而非alias，class_alias()仅作运行时别名且非autoload替代方案。
Composer 不会“消除”类名冲突，它只按配置加载文件；冲突爆发时 PHP 直接 fatal error，没机会补救。真正能做的，是提前切断重复类被同时加载的路径。
运行 composer dump-autoload -o --verbose 定位哪两个文件在打架
这是最直接的起点。终端输出里一旦出现同一类名（比如 App\Helper）对应两个不同路径（如 src/Helper.php 和 vendor/legacy-tool/src/Helper.php），就确认了冲突源。
- 别依赖报错信息里的“Cannot declare class”去反推——它只告诉你炸了，不告诉你炸的是哪两块弹片
-
--verbose必须加，否则 dump 过程跳过路径打印，你只能靠猜 - 如果没显式报错但行为异常（比如某类有时存在有时不存在），手动执行
php -d display_errors=1 -d error_reporting=-1 vendor/autoload.php触发全量加载，更容易暴露重复
检查 autoload_psr4.php 和 autoload_classmap.php 确认映射是否重叠
打开 vendor/composer/autoload_psr4.php，搜索你的类名关键词（如 Helper），看是否出现在多个命名空间前缀下；再搜 vendor/composer/autoload_classmap.php，看同名类是否被静态扫描进了多条记录。
- psr-4 重叠不会报错，但会导致加载顺序依赖配置顺序——先写的路径优先，后写的永远不生效，除非被手动
require - classmap 里出现两条同名类映射，说明
exclude-from-classmap没生效，或你写了文件名（如"Helper.php"）而非完整路径（如"src/Deprecated/Helper.php"） - 路径区分大小写：
"Src/"≠"src/"，Linux/macOS 下会直接忽略错误配置
改 name 字段，而不是改 alias 或删 vendor
如果冲突来自两个同名包（比如都叫 monolog/monolog），alias 字段完全无效——它只影响版本解析，不改变包注册键。Composer 解析阶段看到重复 name 就直接中止，根本不会走到 autoload。
- fork 包必须改
composer.json中的name，例如从"monolog/monolog"改为"acme/monolog" - 改完 name 后，同步更新该包的
autoload.psr-4：若命名空间也改了（如从Monolog\→Acme\Monolog\），映射必须匹配，否则Class not found -
replace只是声明“我代替了某个包”，不自动加载你的代码——autoload 路径仍需你手动对齐
class_alias() 是最后手段，不是 autoload 替代方案
class_alias() 发生在运行时，且要求目标类已被加载完成。它不能解决 autoload 阶段的冲突，只能在两个类已隔离（比如通过 PSR-4 前缀分离）后，给其中一个起别名供旧代码调用。
- 写
class_alias('Old\Logger', 'New\Logger')前，必须确保Old\Logger已被 autoload 加载成功，否则报Class 'Old\Logger' not found - 不能 alias 接口或 trait，PHP 7.4+ 才支持接口 alias，且无实际意义
- 别在
autoload_files里直接写class_alias()——此时 autoloader 尚未初始化，Old\Logger还没定义
真正难处理的从来不是技术动作，而是判断哪个类该留、哪个该移——尤其当冲突来自你无法修改的第三方包时，目录软链 + PSR-4 重映射 + 命名空间迁移，往往比硬改源码更可控，但也意味着你得自己维护路径一致性。
