composer autoload 机制不支持类名别名，仅映射类名到文件路径；解决命名冲突需用命名空间迁移或代理类封装，后者更推荐且兼容性强。
Composer autoload 机制不支持类名别名
Composer 的 autoload（包括 psr-4、classmap）只负责把类名映射到文件路径，它本身**不提供运行时类重命名或别名功能**。你不能像 PHP 的 use SomeClass as Alias; 那样，在 composer.json 里声明“把 VendorAFoo 映射为 MyAppFooV1”。这是常见误解的源头——很多人试图在 autoload 段里加别名字段，结果无效。
真正可行的隔离方式只有两种：命名空间迁移（修改源码）或运行时封装（不改包代码）。前者适合你有权限改依赖，后者是更通用的解法。
用 PSR-4 重映射 + 目录软链隔离同名包
当两个包都提供了 Helper 类，且都位于根命名空间（如 Helper），而你又无法改它们的源码时，可以借助 Composer 的 psr-4 显式映射 + 文件系统隔离：
- 在项目中新建目录
src/VendorA/和src/VendorB/ - 将
vendor/vendor-a/package/src/Helper.php复制（或软链）进src/VendorA/Helper.php，并在文件顶部改命名空间为VendorA - 同理处理另一个包，改为
VendorB - 在
composer.json中添加："autoload": { "psr-4": { "VendorA\": "src/VendorA/", "VendorB\": "src/VendorB/" } } - 执行
composer dump-autoload
注意：软链需确保部署环境支持；复制方式要留意后续上游更新无法自动同步。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
用代理类封装冲突类（推荐用于生产环境）
不碰原包代码、不改命名空间、兼容性最强的方式是写一层薄代理。比如两个包都提供 CacheInterface，但实现互不兼容：
在你的 src/Adapter/ 下创建：
<?php namespace MyAppAdapter;
use VendorACache as CacheA;
use VendorBCache as CacheB;
class CacheAProxy implements MyAppContractsCacheInterface
{
private $inner;
public function __construct() {
$this->inner = new CacheA();
}
public function get($key) { return $this->inner->fetch($key); }
}
class CacheBProxy implements MyAppContractsCacheInterface
{
private $inner;
public function __construct() {
$this->inner = new CacheB();
}
public function get($key) { return $this->inner->get($key); }
}
这样你在业务代码里只依赖 MyAppContractsCacheInterface，通过 DI 容器切换具体实现。既避免了类名冲突，又把耦合点收口在适配层。
require-dev 中的包也可能引发 autoload 冲突
容易被忽略的是：即使某个冲突类只出现在 require-dev 包中，只要它被 autoload 声明过（比如该 dev 包自己写了 psr-4），Composer 就会把它载入全局自动加载列表——进而和 require 中的同名类打架。
排查方法：
- 运行
composer show --platform看是否意外加载了 dev-only 的类映射 - 检查
vendor/composer/autoload_psr4.php，搜索冲突类名，确认来自哪个包 - 若确认是 dev 包引入的干扰，可将其
autoload改为autoload-dev（需该包作者支持）或 fork 后删掉其autoload声明
这类问题往往在 CI 环境突然暴露，因为本地开发时可能没启用全部 dev 包。
