autoload冲突本质是PSR-4映射重叠，即多个路径映射到同一命名空间前缀（如"App": "src/"与"App": "legacy/src/"并存），导致Composer无法确定类文件位置；解决关键是确保每个命名空间前缀有且仅有一个明确磁盘路径映射，禁用模糊前缀，通过独立前缀隔离模块，并用exclude-from-classmap兜底污染源。
autoload 冲突本质是 PSR-4 映射重叠
Composer 的 autoload 冲突，通常不是命名空间“起名重复”，而是 psr-4 配置里多个路径映射到了同一个命名空间前缀，或者一个路径被多个规则覆盖。比如 "App\": "src/" 和 "App\": "legacy/src/" 同时存在，Composer 加载 AppControllerHome 时就不知道该去哪个目录找 Home.php。
解决思路不是靠“加前缀”糊弄命名空间，而是让每个命名空间前缀有且仅有一个明确、无歧义的磁盘路径映射。
用 psr-4 显式隔离不同来源的命名空间
如果你有两个模块（比如主应用和插件），它们都用了 App，但代码物理位置不同，就别强行共用前缀。给插件分配独立前缀更安全：
{
"autoload": {
"psr-4": {
"App\": "src/",
"Plugin\V1\": "plugins/v1/src/",
"Plugin\V2\": "plugins/v2/src/"
}
}
}
这样 PluginV1Renderer 永远只从 plugins/v1/src/Renderer.php 加载，不会和 AppRenderer 冲突。关键点：
-
psr-4键必须以\结尾，否则 Composer 不认作命名空间前缀 - 路径值必须是相对于
composer.json所在目录的相对路径，且结尾不带/ - 不要用
""或"*"作为前缀 —— 这会覆盖所有命名空间，极易引发冲突
已有冲突时，composer dump-autoload -o 不解决问题
很多人遇到类找不到或加载错文件，第一反应是加 -o（优化自动加载）。但这是个常见误解：composer dump-autoload -o 只是把映射关系预生成到 vendor/composer/autoload_psr4.php，它不会修正错误的映射逻辑 —— 错的映射优化后反而更快出错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
真正要做的只有两步：
- 运行
composer dump-autoload --no-cache清掉旧缓存，排除缓存干扰 - 检查
vendor/composer/autoload_psr4.php文件，确认目标命名空间是否真的只对应一个路径数组（例如"App\": ["src/"]） - 如果发现某个前缀对应多个路径（如
"App\": ["src/", "legacy/"]），立刻回composer.json删除或重命名其中一个映射
第三方包引入了同名前缀？优先用 exclude-from-classmap
有些老旧包（尤其 WordPress 插件或私有 SDK）硬编码了 App 却又不遵循 PSR-4，导致你自己的 App 被污染。这时别改它的源码，也不要在自己项目里给它配 psr-4 —— 直接禁止 Composer 扫描它：
{
"autoload": {
"psr-4": { "App\": "src/" }
},
"autoload-dev": { ... },
"include-path": [],
"exclude-from-classmap": ["vendor/bad-pkg/src/App/"]
}
这个配置会让 Composer 在生成 classmap 或 PSR-4 映射时跳过指定路径，既保留包功能（你手动 require 它的文件即可），又避免命名空间污染。注意：exclude-from-classmap 对 psr-4 映射也生效，是实际项目中最常被忽略的兜底手段。
复杂点在于：命名空间本身不冲突，冲突的是映射关系；而映射关系一旦写进 composer.json，就会被所有依赖共享 —— 所以团队协作时，务必把 autoload 区块当作接口契约来 review。
