类名重复本质是psr-4映射失效，需靠psr-4+命名空间+文件路径三重绑定防范；psr-12仅规范格式，不解决冲突。
大项目里类名重复不是命名冲突问题，而是自动加载和命名空间设计失效的信号。PSR-12本身不解决重复，它只提供命名和结构约束；真正防重的是PSR-4 + 命名空间 + 文件路径的三重绑定。
类名重复的本质是PSR-4映射失效
PSR-4要求类名与文件路径严格对应，比如AppServicesUserService必须落在src/Services/UserService.php。一旦两个类同名但路径没隔离（例如都放在src/根下），Composer就无法区分——这不是PSR-12能拦住的，而是PSR-4配置或目录结构错了。
-
composer.json中"psr-4"配置不能有重叠前缀，如同时定义"App\": "src/"和"App\Services\": "legacy/"会引发歧义 - 命名空间末尾必须带反斜杠，
"AppServices"正确，"AppServices"错误（会导致子命名空间解析失败） - 类文件名必须与类名完全一致，大小写敏感：
UserRepository.php里不能定义class userRepository
PSR-12对命名空间和类名的硬性约束
PSR-12不定义“怎么起名”，但强制你用命名空间把类隔开，并规定格式细节，让冲突更容易被发现：
- 命名空间必须用
PascalCase，且每个层级首字母大写：AppHttpControllers✔️，apphttpcontrollers❌ - 类名必须
PascalCase，且不能含下划线：JsonResponse✔️，json_response❌（这会直接导致PSR-12检查失败） - 同一命名空间下不允许两个类同名，哪怕一个在
src/、一个在tests/——因为PSR-4通常只注册src/，测试类走另一套autoload逻辑
实际排查时优先检查这三个地方
遇到Class 'X' not found或意外加载了旧类，别急着改名字，先看底层链路是否断裂：
- 运行
composer dump-autoload -o，确认autoload_classmap.php里有没有两个同名类的路径记录 - 用
composer show --path vendor/package-name验证第三方包是否意外暴露了和你项目同名的类（比如都叫Helper） - 检查IDE或PHPStan是否因缓存误报——删掉
vendor/composer/autoload_classmap.php再重生成
最常被忽略的一点：PSR-12规范本身不校验命名空间层级是否合理，它只管格式。你完全可以写namespace VeryLongAndUnnecessaryNamespacePath;并通过PSR-12检查——但这种设计会让PSR-4映射变得脆弱，稍一疏忽就触发类名覆盖。防重的关键不在“写得规范”，而在“分得清楚”。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
