classmap 查找优先于 psr-4 是因 composer classloader 中 findfile() 方法硬编码将 classmap 检查置于最前，命中即返回，不触发 psr-4 推导；其本质是执行顺序优先而非注册顺序或权限更高。
classmap 不是“优先于”psr-4，而是“先查、命中即停”——classmap 查表是 autoload 流程的第一步，只要类名在 autoload_classmap.php 里有记录，就直接加载，根本不会走到 psr-4 推导逻辑。
为什么 classmap 查找总在 psr-4 之前触发
Composer 生成的 vendor/autoload.php 会按固定顺序注册加载器：files → psr-4 → classmap → psr-0。但实际执行时，PHP 的 spl_autoload_register() 是逐个调用这些加载器的；而 Composer 内置的 ClassLoader 实现中，classmap 查找被硬编码在 findFile() 方法最开头，它不依赖注册顺序，而是加载器内部的逻辑优先级。
-
classmap是一张静态数组（vendor/composer/autoload_classmap.php），查找是 O(1) 哈希匹配，快且确定 -
psr-4需要截掉命名空间前缀、替换\为/、拼路径、再file_exists()，是动态推导 + 文件系统 IO - 哪怕你把
psr-4配置写在composer.json顶部，classmap映射仍会在运行时被优先检查
classmap 覆盖 psr-4 的真实条件
覆盖不是靠“更优先”，而是靠“更早命中”。一个类同时满足两种规则时，classmap 生效的前提是：该类名确实出现在 autoload_classmap.php 中。这通常发生在以下情况：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 你在
composer.json的"classmap"字段里显式包含了该类所在目录（例如"src/"），且运行过composer dump-autoload - 该类文件被扫描到，并生成了
"AppHelper"→"src/Helper.php"这样的映射项 - 而你的
psr-4配置是"App\": "src/"，此时new AppHelper()会走 psr-4（因为类名以App开头），但new Helper()（无命名空间）只能走classmap - 如果你误把
src/Helper.php同时纳入classmap和psr-4路径，又写了namespace App;，那new Helper()仍走classmap，new AppHelper()则走psr-4—— 类名不同，不冲突
怎么验证当前类到底走哪个加载路径
别猜，直接看生成的映射文件和运行时行为：
- 运行
composer dump-autoload -v，观察输出里是否提到 “Scanning dir src/ for classmap” 或 “Found class Helper in src/Helper.php” - 打开
vendor/composer/autoload_classmap.php，搜索类名，如果存在，说明已进 classmap - 打开
vendor/composer/autoload_psr4.php，确认你的命名空间前缀（如"App\"）是否对应正确路径（如["src/"]） - 临时加一句
var_dump($loader->findFile('Helper'));在require 'vendor/autoload.php'后，看返回路径是src/Helper.php还是src/Http/Helper.php等
classmap-authoritative 模式下 psr-4 彻底失效
启用 --classmap-authoritative 后，Composer 加载器会跳过所有文件系统扫描逻辑，只查 autoload_classmap.php。此时：
- 任何未被 classmap 收录的类，即使符合 psr-4 规则，也会报
Class not found - 必须确保
"classmap"字段在composer.json中存在（哪怕为空数组），否则该 flag 不生效 - 运行
composer dump-autoload --classmap-authoritative --optimize-autoloader后，检查autoload_classmap.php是否非空；若为空，说明没扫到任何类——可能路径配置错误，或类文件放在了未声明的目录（如tests/）
最容易被忽略的一点：classmap 的“优先”本质是“唯一入口”，不是“更高权限”。一旦你启用了 --classmap-authoritative，psr-4 就不再是备选方案，而是完全不可用——它连尝试的机会都没有。
