“class not found”实为类名冲突导致——composer按psr-4顺序加载，php首次加载同名类后，再次声明即报fatal error: cannot declare class；常见于多版本依赖或自定义类未加唯一命名空间。
为什么 composer autoload 会报“Class not found”却又有同名类？
不是找不到类，而是找到了两个——composer autoload 按 PSR-4 规则扫描目录时，若不同包（或同一包不同版本）里存在相同命名空间+类名的文件，PHP 在首次 require 时只会加载第一个匹配项。后续再 new 或 use 同名类，就会触发 Fatal error: Cannot declare class X, because the name is already used。
典型场景：你同时依赖 monolog/monolog v1 和 v2 的某个间接依赖（比如某 SDK 锁死了 v1，而你的新模块用了 v2 的 LoggerInterface），或者自己写了同名工具类没加唯一命名空间。
- 别指望 Composer 自动帮你“选对”——它只按
autoload配置顺序加载，不校验冲突 -
class_alias()不是 autoload 机制的一部分，它发生在运行时，且仅作用于类名映射，不影响自动加载路径 - 冲突往往在 CLI 命令或测试启动时暴露，Web 请求可能因请求顺序偶然“不报错”，更具迷惑性
什么时候该用 class_alias() 而不是改命名空间？
当你无法修改第三方代码、又不能统一升级所有依赖（比如老系统要兼容某支付 SDK 的 v1.2，但新报表模块必须用它的 v2.5），且两个版本的类签名高度一致（方法名、参数、返回值基本兼容）时，class_alias() 是最轻量的解耦手段。
它本质是给一个已加载的类起别名，让新旧代码能共存。但注意：class_alias('Old\Logger', 'New\Logger') 并不会让 New\Logger 被自动加载——你得确保 Old\Logger 已通过 autoload 加载成功，否则会报 Class 'Old\Logger' not found。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 别在
autoload_files里直接写class_alias()——此时 autoloader 尚未初始化，Old\Logger还没加载 - 最佳位置是入口文件（如
index.php或console脚本开头），或服务容器初始化前 - 别 alias 接口或 trait——PHP 7.4+ 才支持接口 alias，且无实际意义；trait 不能 alias
class_alias() 的真实调用时机和常见陷阱
很多人以为写一句 class_alias('A', 'B') 就万事大吉，结果发现 B 还是报错。核心问题在于：alias 必须在目标类已被定义后执行，且不能重复执行（否则 Warning: Cannot redeclare class）。
示例：你想把 Monolog\Logger（v1）映射为 Psr\Log\LoggerInterface（v2 接口），但后者是接口，不能 alias 成类——这是典型误用。正确做法是 alias 到一个中间类名，再让业务代码 use 这个中间名。
- 检查是否已定义：
if (!class_exists('NewName')) { class_alias('OldName', 'NewName'); } - 避免在循环或多次 include 的文件中无条件调用——加
defined()或class_exists()防重 - Composer 的
autoloader->addClassMap()是静态映射，和class_alias()互不影响，但别混用——前者改的是加载逻辑，后者改的是运行时符号表
比 class_alias() 更稳的替代方案有哪些？
alias 是临时止血，长期仍建议解耦。真正健壮的做法是分层隔离：
- 用 Adapter 模式封装第三方类：写一个
MonologV1Adapter implements Psr\Log\LoggerInterface，内部代理调用Monolog\Logger方法 - 利用 Composer 的
replace字段声明冲突，在composer.json中显式告诉 Composer “我用 A 替代 B”，阻止 B 被安装 - 升级到 PHP 8+ 后，考虑用
#[\Attribute]或契约优先设计，减少对具体类名的强依赖
alias 解决的是“现在跑起来”，但类名冲突背后往往是架构耦合——下次看到 Fatal error: Cannot declare class，先 grep 全局找重复定义，再决定要不要 alias。
