autoloader-suffix 用于为 Composer 自动生成的自动加载器初始化类添加唯一后缀，防止多项目共用缓存时类名冲突；需在 composer.json 根级配置，如 "autoloader-suffix": "MyProjectAlpha"，并执行 composer dump-autoload。
composer.json 里 autoloader-suffix 是干啥的
它不是用来“隔离”自动加载逻辑的，而是给 Composer 生成的 autoloader 类起个唯一后缀，避免多个项目或多个 Composer 实例共用同一份缓存时类名冲突。比如你在同一个 PHP 进程里 require 了两个不同项目的 vendor/autoload.php，没加后缀的话，它们都试图定义 ComposerAutoloaderInit 这个类，直接报 Fatal error: Cannot redeclare class。
所以它的核心作用是「类名防重」，不是命名空间或加载路径隔离。
怎么在 composer.json 中正确设置 autoloader-suffix
直接写进根级配置即可，不需要插件或额外命令：
{
"autoloader-suffix": "MyProjectAlpha"
}
执行 composer dump-autoload 后，生成的 vendor/autoload.php 会引用类似 ComposerAutoloaderInitMyProjectAlpha 的初始化类，而不是默认的 ComposerAutoloaderInit。
- 值必须是合法 PHP 类名：只能含字母、数字、下划线，且不能以数字开头
- 修改后必须重新运行
composer dump-autoload（install或update也会触发） - 这个字段只影响自动生成的初始化类名，不影响 PSR-4/PSR-0 映射行为
为什么改了 suffix 还是报类重复？常见漏点
最常踩的坑是——你以为改了就完事，但旧的 autoload 文件还在被加载。
- PHP OPcache 缓存了旧的
vendor/autoload.php或其包含的类，要清 OPcache（opcache_reset()或重启 PHP-FPM） - 某些测试框架（如 PHPUnit）或 CLI 工具会预加载 vendor/autoload.php 一次，后续 require 不生效；得确保整个进程从头开始用新 suffix
- 多个
vendor/autoload.php被同时 require，但只有一个设了 suffix —— 其余没设的仍用默认名，照样冲突 -
composer.lock不影响该配置，但如果你用的是旧版 Composer（
和 PSR-4 自动加载路径隔离有关系吗
没有。这是两件事：autoloader-suffix 只改类名，不改任何文件查找逻辑；PSR-4 的映射路径由 autoload.psrs-4 控制，路径前缀、命名空间、目录绑定全靠它。
想真正“隔离”加载行为，你应该：
- 用不同
vendor-dir配置分隔依赖目录 - 在
autoload.psrs-4里用不同命名空间前缀（如"MyApp\Alpha\"vs"MyApp\Beta\"） - 或者干脆用多个独立 Composer 项目，不共享 autoload.php
把 autoloader-suffix 当成“多实例共存的安全补丁”，而不是加载策略开关——它救不了设计层面的耦合。
