composer不支持自定义类查找规则，类名冲突本质是php运行时限制；解决需改命名空间或加代理层，class_alias()仅限临时绕过且有严格前提。
Composer 本身不提供“自定义类查找规则”的能力，所谓“类名混淆兼容”不是配置问题，而是 PHP 运行时机制限制下的权衡选择——你无法让两个同名类共存，只能控制谁先被加载、谁被绕过、或用运行时手段做映射。
class_alias() 能用但必须满足三个前提
很多人试了 class_alias('OldLogger', 'PsrLogLoggerInterface') 然后报错，不是语法错，是时机和类型错：
-
OldLogger必须已通过 autoload 成功加载（class_exists('OldLogger')返回 true），否则会报Class 'OldLogger' not found - 目标名不能是接口或 trait ——
class_alias()只支持类到类的映射，PHP 7.4+ 虽允许 alias 接口，但无实际作用，IDE 和反射均不识别 - 同一别名不能重复执行，否则触发
Warning: Cannot redeclare class；建议加保护：if (!class_exists('NewLogger')) { class_alias('OldLogger', 'NewLogger'); }
PSR-4 映射重叠时，谁生效取决于声明顺序而非路径优先级
你在 composer.json 里写了两条 "App\": "src/"，Composer 不会合并或报错，而是按配置出现顺序注册。假设 A 包和 B 包都声明了这个映射：
- 如果 A 在前、B 在后，
composer dump-autoload生成的autoload_psr4.php里只保留 A 的映射 - B 包里的
AppFoo永远不会被 autoload 找到，除非你手动require它 - 但一旦你手动
require 'vendor/b/package/src/Foo.php'，而 A 的AppFoo已加载，立刻触发Fatal error: Cannot declare class
验证方式：打开 vendor/composer/autoload_psr4.php，搜索 "App"，看剩下几条。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
exclude-from-classmap 只对 classmap 生效，对 PSR-4 无效
你想屏蔽某个冲突类，却在 composer.json 里写："exclude-from-classmap": ["Helper.php"] —— 这完全不起作用：
- 它只接受**完整路径**，例如
"src/Deprecated/Helper.php"或目录"legacy/"（末尾斜杠不可省） - 路径区分大小写：
"Src/"≠"src/"，Linux/macOS 下会失效 - 它对 PSR-4 自动加载毫无影响 —— PSR-4 是运行时推导路径，
exclude-from-classmap只在生成autoload_classmap.php阶段起作用
真正能落地的解法只有两种：改命名空间或加代理层
别再纠结 autoload 配置能不能“智能选类”，PHP 解析器不认这个逻辑：
- 如果你能改源码：把冲突类移到唯一命名空间下，比如把
Helper改成VendorAHelper，并同步更新composer.json中的psr-4映射 - 如果你不能改第三方包：写一个薄代理类，例如
MyAppV1Helper内部new VendorAHelper()，业务代码只依赖这个代理，隔离实现细节 - 别用
class_alias()替代设计 —— 它会让get_class()、instanceof、IDE 跳转、静态分析全部失准，只适合临时绕过、测试场景
最常被忽略的是：类名冲突往往不是 Composer 的问题，而是项目早期没约束命名空间边界，后期靠 patch 弥补，成本远高于初期规范。
