Composer不解决命名空间冲突，只按配置注册PSR-4映射；同前缀（如App）会导致运行时Fatal error: Cannot declare class——无警告、不重试。
Composer 不会自动解决命名空间或路径冲突，它只按配置注册加载规则；一旦两个包声明了相同 PSR-4 前缀（如 App），PHP 运行时直接报 Fatal error: Cannot declare class——没有警告，不给重试机会。
怎么确认是真冲突还是 autoload 根本没生效
很多“类重复定义”其实是类压根没被正确加载，先排除这个高频低级问题：
- 检查入口文件是否真的
require了vendor/autoload.php，CLI 脚本里漏写这行非常常见 - 用
file_exists(__DIR__ . '/vendor/autoload.php')手动验证路径，尤其注意 Web 环境下$_SERVER['DOCUMENT_ROOT']和脚本实际位置可能不一致 - 运行
composer dump-autoload -v，看输出里有没有扫到你的命名空间和对应文件；如果完全没出现，说明composer.json的autoload配置无效（比如缩进错、逗号漏、PSR-4 末尾少反斜杠） - 删掉
vendor/composer/autoload_*.php后再跑dump-autoload，避免旧缓存干扰
PSR-4 命名空间前缀撞车的典型表现和解法
最常见冲突来源：两个包都配了宽泛前缀，比如都用了 "App": "src/" 或 "": "src/"。Composer 会把它们全注册进 autoloader，运行即崩。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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"） - 你自己项目中，绝不要把多个第三方包的源码目录塞进同一个命名空间下——哪怕只是放一个
Helper.php - 优先推动包作者收紧前缀，例如从
"App": "src/"改成"VendorName\Package": "src/" - 若无法推动上游修改，可在你项目的
composer.json中用exclude-from-classmap主动屏蔽冲突文件（注意：这只对classmap有效，对 PSR-4 无效）
classmap 和 PSR-4 混用时谁优先？
classmap 查表是 autoload 流程的第一步，一旦命中就直接返回路径，完全跳过 PSR-4 推导。这意味着：
- 如果你在
classmap里手动加了"src/Helper.php"，那么new Helper()就走classmap；而new AppHelper()仍走 PSR-4 —— 类名不匹配，不会混 - PSR-4 映射必须以反斜杠结尾：
"App": "src/"✅，"App": "src"❌（后者会导致类名解析多一层） -
classmap路径写相对路径（如"lib/"），不能写"./lib/"或绝对路径 - 执行
composer dump-autoload -o后，classmap生成完整列表，但 PSR-4 映射仍保留 fallback 行为
离线环境或 Windows PATH 冲突怎么办
离线时 vendor/autoload.php “看起来生效但实际没加载”，常因缓存或路径错位导致；Windows 下则容易因多个 composer.bat 文件触发命令解析失败。
- 重启 PHP-FPM 或 Web 服务器（不是 reload，是 stop + start），并清空 opcache：
opcache_reset()或运行php -r "opcache_reset();" - 临时禁用 opcache 验证：把
opcache.validate_timestamps=1加进php.ini，离线调试更可控 - 在 Windows 上运行
where composer，查看 PATH 中所有composer相关路径；若第一个是 XAMPP/OpenServer 自带的损坏composer.bat，需调整 PATH 顺序或删掉它 - 检查
vendor/composer/autoload_static.php修改时间，和composer.json修改时间对比，不一致说明dump没真正生效
真正难处理的不是报错本身，而是冲突发生在 PSR-4 映射层——它不报错、不提示、只静默覆盖，直到某个类被 new 出来才崩。所以每次加新包，都要立刻查 composer dump-autoload -v 输出，确认你的命名空间确实被注册了，且没被别的包顶掉。
