Composer不处理类名冲突，仅按配置注册加载规则；同名类会导致PHP致命错误。需先验证autoload是否生效，再检查PSR-4前缀、classmap优先级及离线环境配置。
Composer 不会处理类名或命名空间冲突，它只照单全收配置、原样注册加载规则；一旦两个包都声明了 AppHelper，PHP 就会在第二次加载时直接报 Fatal error: Cannot declare class AppHelper——没商量，不预警，立刻崩。
怎么确认是真冲突，还是 autoload 根本没生效
很多“类冲突”其实是 autoload 压根没跑起来，先排除这个高频低级错误：
- 检查入口文件是否真的
require 'vendor/autoload.php'，CLI 脚本里漏写这行太常见 - 用
file_exists(__DIR__ . '/vendor/autoload.php')手动验证路径，Web 环境下$_SERVER['DOCUMENT_ROOT']和脚本实际位置可能不一致 - 删掉
vendor/composer/autoload_*.php后再跑composer dump-autoload，避免旧缓存干扰
PSR-4 映射重复或前缀过宽是最常见冲突源
Composer 对 PSR-4 映射不做校验，多个包同时声明 "App\": "src/" 或 "": "src/"，就会导致后加载的规则覆盖前一个，但 PHP 不允许同名类重复定义：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查所有依赖包的
composer.json中autoload和autoload-dev字段，重点看有没有泛用前缀（如"App\": "src/"） - 你自己项目中，绝不要把多个第三方包的源码目录塞进同一个命名空间下——哪怕只是放一个
Helper.php -
psr-4映射的命名空间必须以反斜杠结尾："App\": "src/"✅，"App\": "src"❌（后者会导致类名解析多一层） - 路径必须是相对路径（如
"src/"），不能写"./src/"或绝对路径
classmap 和 PSR-4 混用时谁优先？
classmap 是 autoload 流程的第一步，一旦命中就直接返回路径，完全跳过 PSR-4 推导：
- 如果你在
classmap里手动加了"src/Helper.php"，那么new Helper()就走classmap；而new AppHelper()仍走 PSR-4 —— 类名不匹配，不会混 -
composer dump-autoload -o后，classmap生成完整列表，但 PSR-4 映射仍保留 fallback 行为；若误加--classmap-authoritative，会删掉 PSR-4 回退逻辑，反而让某些动态加载失败 - 对 PSR-4 无效的
exclude-from-classmap只能屏蔽classmap中的文件，不能解决 PSR-4 层面的命名空间重叠
离线环境下 autoload 失效怎么查
离线时 composer install 可能跳过 autoload 重建，导致 vendor/autoload.php 里没注册新类或路径变更后的类：
- 执行
composer dump-autoload --optimize强制重建映射（别加--classmap-authoritative） - 检查
composer.json中autoload是否含本地路径（如"src/": ["src/"]），离线时这些路径必须真实存在且未被.gitignore误删 - 离线无法靠 Composer 自动 resolve 冲突，
dump-autoload会按composer.json里require的顺序合并映射，后加载的包可能覆盖先加载的同名类 -
vendor/composer/autoload_static.php被 OPcache 缓存旧版本很常见，改完配置后记得opcache_reset()或重启 PHP 进程
真正麻烦的不是配置写错，而是多个包在你不知情时悄悄共享了同一命名空间——这种冲突往往只在特定组合、特定 PHP 版本或 OPcache 开启时才暴露，得靠 composer show --tree 和手动翻 vendor/composer/autoload_psr4.php 对着看。
