autoload冲突本质是PSR-4映射重叠：Composer按composer.json声明顺序优先匹配，一旦前序规则捕获命名空间，后续同名或父级规则即失效；需手动调整顺序与粒度，将更具体的命名空间（如"AppService"）置于更宽泛的（如"App"）之前。
autoload 冲突的本质是 PSR-4 映射重叠
Composer 不会“合并”冲突的 autoload 路径，而是按 composer.json 中声明的顺序优先匹配——一旦某个命名空间被前面的 PSR-4 规则捕获，后续同名或父级命名空间的规则就完全失效。典型现象是：类文件存在、路径配置也写了，但 class not found；或者修改了 vendor 外的本地包路径，结果还是加载了旧版本。
检查冲突用 composer dump-autoload -v
加 -v 参数会输出所有生效的 PSR-4 映射及其来源（哪个 composer.json），能一眼看出是否被覆盖或重复注册：
composer dump-autoload -v
重点关注两处：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 同一命名空间出现在多个位置（比如
"App\": "src/"和"App\": "packages/myapp/src/"） - 子命名空间被父级映射吞掉（如先写
"App\": "src/"，再写"App\Service\": "app-services/src/"—— 后者永远不生效）
解决必须手动调整顺序和范围
Composer 没有自动去重或智能合并机制。你得自己控制声明顺序和命名空间粒度：
- 把更具体的命名空间（如
"App\Service\"）放在更宽泛的（如"App\"）之前 - 避免用
"App\"这种顶层映射兜底，改用精确前缀，比如"App\Controller\"、"App\Model\"分开配 - 如果要让本地开发包优先于 vendor 包，确保它的
autoload块在根项目composer.json中，且顺序靠前；不要依赖repositories+path自动注入，它生成的 autoload 是后加载的 - 临时调试可用
"files"加载单个工具函数文件，它不参与命名空间匹配，无冲突风险
vendor/autoload.php 本身不能被“合并”
每次运行 composer dump-autoload，都会完整重写 vendor/autoload.php 和 vendor/composer/autoload_*.php。你无法在生成后手动追加路径——下次 dump 就会被清空。所有路径必须回归到 composer.json 的 autoload 或 autoload-dev 字段里声明。
真正容易被忽略的是：有些框架（如 Laravel）会在服务提供者里手动调用 ClassLoader::addPsr4()，这种运行时注册会绕过 Composer 的 autoload 配置，也容易和静态配置打架——查问题时得同时看代码里有没有这类动态注册。
