class not found 或 cannot declare class 的根本原因常是 autoloader 未正确加载类，而非命名冲突；需验证 class_exists()、检查 autoload_psr4.php 映射、区分 classmap 与 psr-4 优先级，并确保 fork 包修改 name 字段及对应 autoload 配置。
Class not found 或 Cannot declare class？先确认是不是真冲突
很多报错看似是命名空间污染，其实是 autoload 根本没走对路。比如你在 CLI 脚本里漏写了 require 'vendor/autoload.php'，或者 Web 入口用了 $_SERVER['DOCUMENT_ROOT'] 拼路径导致实际加载的是旧缓存文件。
验证方式很简单：在出错脚本开头加一行 var_dump(class_exists('SomeClass'));，返回 false 就说明类压根没被注册进 autoloader，不是“重复”，而是“没加载”。
还要检查 vendor/composer/autoload_psr4.php，搜索你的类名关键词——如果它出现在两个不同路径下（比如两行都含 "App\" => ["src/"]），才是撞车实锤。
PSR-4 前缀宽泛导致覆盖？改映射或加隔离层
最常见污染源是两个包都配了 "" => "src/" 或 "App" => "src/" 这种宽泛前缀。Composer 不去重，只按 composer.json 顺序注册，后注册的会覆盖前注册的映射，但 PHP 加载时谁先 new 谁生效，行为不可控。
可行解法只有两个：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 推动上游收紧前缀，比如从
"App\"改成"VendorName\Package\" - 你本地做隔离：新建
src/VendorA/和src/VendorB/目录，把冲突类复制进去并改顶部命名空间，再在composer.json中显式加"VendorA\": "src/VendorA/"和"VendorB\": "src/VendorB/"，最后执行composer dump-autoload
"App\": "src/" ✅，"App\": "src" ❌；软链方式要确认部署环境支持，复制方式需手动同步上游更新。
classmap 和 PSR-4 混用时谁优先？别让 classmap 成为隐藏雷区
classmap 是 autoload 流程的第一道关卡，一旦命中就直接返回路径，完全跳过 PSR-4 推导。这意味着如果你在 composer.json 的 classmap 里写了 "src/Helper.php"，那么 new Helper() 就走 classmap；而 new AppHelper() 仍走 PSR-4 —— 类名不匹配，不会混，但容易误判来源。
排查建议：
- 运行
composer dump-autoload -v，看输出里是否扫到了你预期的类路径 - 删掉
vendor/composer/autoload_*.php后再跑一次dump-autoload，避免旧缓存干扰 - 检查
exclude-from-classmap是否误屏蔽了本该加载的文件（它只对classmap生效，对 PSR-4 无效）
fork 包重名导致 Package is already registered？name 字段必须改
报错 Package monolog/monolog is already registered 不是版本问题，是 Composer 在内存注册阶段就拒绝了——name 是唯一键，URL、分支、tag 全都不算数。哪怕你 fork 并改了 1000 行，只要 "name": "monolog/monolog" 没动，它就跟官方包“撞身份证号”。
必须同步做三件事：
- 改
composer.json中的name，推荐带组织前缀，如"acme/monolog"，避免用"monolog_custom"这类易与未来官方包重名的写法 - 同步更新
autoload配置：如果命名空间从Monolog\改成Acme\Monolog\，PSR-4 映射也得跟着改 - 主项目中
require要指向新 name，并在repositories中声明你的源；若其他依赖间接引用原包，还得加replace声明替代关系
replace 不自动加载你的代码，类路径还得靠 autoload 正确映射——这点最容易被忽略。
