classmap能解决三类autoload冲突：无命名空间的老代码、命名空间与目录结构不一致、同名类需强制指定加载路径；关键要隔离目录、避免psr-4覆盖、用-dump-autoload -a重扫并验证映射。
classmap 能解决哪些 autoload 冲突
classmap 不是用来“修复” PSR-4 配置错误的，而是绕过命名空间匹配逻辑，直接把类名硬映射到文件路径。它适合三类场景：
• 类没声明 namespace（比如老项目里的 DatabaseSeeder）
• 命名空间和目录结构不一致（如 namespace App\Legacy; 但文件在 legacy/ 目录下）
• 同一类名在多个路径下存在，你想强制指定加载哪一个（比如测试用桩类和生产类同名）
怎么写 classmap 配置才不被 PSR-4 覆盖
PSR-4 和 classmap 共存时，Composer 默认优先走 PSR-4 规则——哪怕你配了 classmap，只要某个类名能被 PSR-4 “猜中”，就不会查 classmap。所以关键不是加，而是隔离：
• 把 classmap 指向**完全不参与 PSR-4 映射的目录**，例如 "classmap": ["legacy/", "seeds/", "helpers/"]
• 确保这些目录里没有和 PSR-4 前缀冲突的命名空间（比如别让 legacy/ 下出现 namespace App\;）
• 运行 composer dump-autoload -a（-a 强制重扫，-o 不够，它只优化已有映射）
• 检查生成的 vendor/composer/autoload_classmap.php，确认你要的类名（如 'DatabaseSeeder'）真出现在数组里，而不是空的 return array();
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
为什么 classmap 加了还是找不到类
常见原因不是配置漏了，而是扫描阶段就被跳过：
• 文件扩展名不是 .php（.inc、.php5、.class.php 都不会被 classmap 扫描）
• 文件里没有 class、interface 或 trait 声明（纯函数文件必须放 files 字段，不是 classmap）
• 目录路径是相对 composer.json 的真实路径，但写成了 "legacy"（缺末尾 /），导致 Composer 当成文件名去读，报错 Could not open input file
• 用了 --classmap-authoritative 但 classmap 没扫全，结果运行时连 fallback 查找都禁了，直接 Class not found
classmap 和 files 混用时的坑
两者目的不同，混用容易互相干扰：
• files 是无条件 require，适合全局函数（如 helpers.php），但每次请求都执行，无法按需加载
• classmap 是按类名触发 require，性能更好，但只认 class/interface/trait
• 如果你在 files 里 require 了一个含类定义的文件，又把它加进 classmap，就会导致重复定义 fatal error
• 实操建议：纯函数 → files；有类但无命名空间 → classmap；有命名空间且结构规整 → psr-4，三者不要交叉覆盖同一类
composer dump-autoload -a，否则映射就断了。而 PSR-4 是动态推导的，这点反而更鲁棒。
