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 Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 就不再是备选方案，而是完全不可用——它连尝试的机会都没有。