Composer不支持运行时类名别名，“as”仅影响版本解析，不改变命名空间或文件路径；类覆盖需通过代理类封装、PSR-4重映射或classmap优先级实现，且必须同步更新use语句和硬编码调用。
Composer 本身不支持运行时类名别名，所谓“覆盖类”，本质是绕过原包 autoload 注册、让自己的实现优先进入自动加载路径。别名（as）只影响版本解析，对类加载毫无作用——这是绝大多数人踩坑的起点。
为什么 composer.json 里的 as 别名无法覆盖类？
别名只是告诉 Composer：“这个分支/提交，对外声称是某个稳定版本号”，它不修改文件路径、不重写命名空间、不干预 vendor/autoload.php 的注册逻辑。两个包只要都声明了 "psr-4": {"Monolog\": "src/"}，它们的 MonologLogger 就会同时被注册进自动加载器，最终必然触发 Cannot declare class MonologLogger。
常见错误现象：
- 写了
"monolog/monolog": "dev-fix as 2.10.0"，但运行时仍报类重复定义 -
composer show monolog/monolog显示 version 是2.10.0，误以为“已覆盖成功” - 删了
vendor/重装，问题依旧
真正能覆盖类的三种方式（按推荐度排序）
核心原则：不改原包代码，也不依赖别名，而是控制自动加载顺序或封装调用入口。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
代理类封装（最推荐）：在
src/MyApp/Monolog/Logger.php中定义class Logger extends MonologLogger，或完全重写逻辑；然后在业务代码中use MyAppMonologLogger。无需动 Composer 配置，兼容性最强 -
PSR-4 显式重映射 + 文件隔离：在
composer.json中禁用原包 autoload（加"autoload-dev": {"psr-4": []}或用replace），再手动添加你自己的映射："psr-4": {"Monolog\": "src/monolog-patched/"}；把原包src/复制进该目录并修改命名空间为Monolog\ -
classmap + 路径优先级：用
"classmap": ["src/patched-classes/"]，把重写的类文件放进去（文件名必须和类名一致），确保它比原包classmap更早注册——这依赖vendor/autoload.php中的注册顺序，不可靠，仅作临时调试
autoload 配置里哪些字段会影响类覆盖效果？
关键不是“加什么”，而是“删什么”和“顺序怎么排”。
-
"autoload": {"psr-4": {...}}和"autoload-dev": {...}是独立注册的，后者不会覆盖前者 - 若原包用了
"files"加载全局函数，你无法覆盖，只能确保你的files在vendor/autoload.php中更早执行（通过在根项目autoload.files里前置声明） -
"exclude-from-classmap"可用于屏蔽原包某些类文件，但仅对classmap有效，对 PSR-4 无效 - 运行
composer dump-autoload -o后检查生成的vendor/composer/autoload_psr4.php，确认你的映射是否出现在原包之前
容易被忽略的陷阱：autoload 与 replace 的配合边界
replace 字段能阻止原包安装，但它不自动接管 autoload —— 你仍需自己配置 autoload 映射，否则类根本不会被加载。
例如，想用自研日志库替代 monolog/monolog：
- 只写
"replace": {"monolog/monolog": "*"}→ 原包不装了，但你的类也不会自动加载 - 必须额外配
"autoload": {"psr-4": {"Monolog\": "src/monolog/"}}，且确保src/monolog/Logger.php存在并声明namespace Monolog; - 如果原包有 bin 文件（如
monolog/bin/monolog-cmd），replace不会帮你提供替代命令，得自己写 wrapper 脚本
最麻烦的点往往不在配置本身，而在于：你改了 autoload 映射，但忘了同步更新所有 use 语句里的命名空间，或者没意识到某些第三方包内部硬编码了 new MonologLogger()，这类调用仍会失败。
