Composer不支持命名空间别名，所谓“别名”实为PSR-4双重映射（如"Legacy": "src/", "App": "src/"），需双反斜杠结尾、执行dump-autoload，并同步清理所有引用。
Composer 本身不支持命名空间别名
你在 composer.json 的 autoload 段里写 "OldApp": "src/old/" 或 "App": "src/new/"，这根本不是“别名”，只是 PSR-4 映射。Composer 不会把 OldAppSomeClass 自动转成 AppSomeClass —— 它只按字面注册路径，类文件必须真在那个命名空间下。所谓“别名”是开发者自己用映射、class_alias() 或目录复用模拟出来的，不是 Composer 原生能力。
常见误解来源："as" 只在 repositories + require 中用于版本伪装（如 "dev-main as 2.0.0"），和自动加载无关；replace 字段影响依赖解析，但不改类加载路径。
PSR-4 双重映射可临时兼容旧命名空间
如果你有大量遗留代码还在用 LegacyXxx，但新代码已迁到 AppXxx，又不能一次性全改，可以用 PSR-4 同时映射两个前缀到同一目录：
{
"autoload": {
"psr-4": {
"Legacy\": "src/",
"App\": "src/"
}
}
}
这样 src/Xxx.php 既能被 new LegacyXxx 加载，也能被 new AppXxx 加载。但要注意：
-
Legacy\和App\都必须以双反斜杠结尾，少一个就失效 - 这种做法会让 IDE 和静态分析工具困惑，类型提示可能错乱
- 不能解决同名类冲突：如果
LegacyFoo和AppFoo实际指向不同文件，PHP 仍会报Fatal error: Cannot declare class Foo - 执行
composer dump-autoload -o后，打开vendor/composer/autoload_psr4.php确认两条映射都存在
删废弃 autoload 映射前必须做三件事
直接删 composer.json 里的旧 PSR-4 条目，极大概率导致运行时报 Class not found 或更隐蔽的加载错位。必须同步完成：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 全局搜索残留引用：
grep -r "Legacy\\Namespace" --include="*.php" .，覆盖use、new、字符串拼接、注解等所有形式 - 删掉
composer.json对应条目后，立刻执行composer dump-autoload -o && composer clear-cache；跳过-o会导致 classmap 缓存残留，旧路径仍可能被加载 - 检查框架配置：Laravel 的
config/app.php、Symfony 的config/services.yaml是否绑定了旧类名，这些不会被 Composer 自动感知
特别注意：vendor/composer/autoload_psr4.php 是最终生效表，删完映射后它里面不应再出现对应行。
class_alias() 是运行时补救，但有硬伤
仅当迁移窗口极短、无法改调用方时，才考虑在引导文件中用 class_alias() 做轻量级桥接：
require_once __DIR__ . '/vendor/autoload.php';
class_alias('AppNewHelper', 'LegacyOldHelper');
但它的问题很实际：
- 反射失效：
(new ReflectionClass('LegacyOldHelper'))->getName()返回AppNewHelper，破坏依赖注入容器行为 - IDE 无法跳转、类型提示丢失、PHPStan/PHPStorm 报告误报
- 不能用于 trait、interface 或 abstract class
- 必须确保在所有使用前执行，且不能重复调用（否则 PHP 报
Cannot redeclare class）
真正干净的解法永远是：改源码命名空间 + 同步更新所有引用。别指望靠 alias 绕过这个过程——它只是延缓爆炸时间点。
