composer类加载顺序固定为files→classmap→psr-4/psr-0，不可配置；files无条件优先执行require_once，classmap次之并需dump-autoload生成，psr-4最后fallback匹配。
Composer 不支持自定义类加载顺序，它按固定优先级执行：files → classmap → PSR-4/PSR-0；你不能调整这个顺序，但可以通过配置控制“哪些类走哪条路径”。
为什么不能改加载顺序
Composer 的自动加载器（vendor/autoload.php）内部用 spl_autoload_register() 注册了多个 loader，它们的注册顺序是硬编码的：files 最先、classmap 次之、psr-4 最后。这个顺序无法通过 composer.json 配置更改，也不该被覆盖——否则会破坏 class_exists() 行为、引发重复定义或静默跳过。
常见错误现象：Class 'AppHelper' not found，但 helper 类明明在 src/Helper.php 里；实际是它被误配进 psr-4，而文件没命名空间、也没按目录结构放，结果 fallback 到 PSR-4 拼路径失败，又没 fallback 回 classmap（因为 classmap 没启用）。
- 强行在
autoload.php里调用spl_autoload_register()追加 loader，会导致加载器重复注册、顺序错乱、OPcache 失效 - 把同一个类同时放进
files和psr-4映射，PHP 会报Fatal error: Cannot declare class（files先执行，psr-4后加载时再 require 就重复） -
autoload-dev下的规则只在--no-dev未启用时才参与加载，CI 脚本若默认加了该参数，autoload-dev.files根本不生效
files 加载时机与执行顺序
files 是唯一真正“无条件、按序执行”的机制——它不是类加载，而是自动 require_once。它的顺序由数组声明顺序决定，且在所有类加载逻辑启动前就完成。
适用场景：全局函数、常量定义、class_alias()、简单初始化（如 mb_internal_encoding('UTF-8')）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"files": ["src/constants.php", "src/helpers.php"]→constants.php先加载，helpers.php后加载，后者可安全使用前者定义的常量 - 路径必须真实存在，且以
.php结尾；写成"helpers"或"src/"会被忽略，不报错也不加载 - 文件内禁止
echo、new PDO()、file_get_contents()等副作用代码——它们会在composer dump-autoload过程中就被执行，导致命令直接中断
classmap 和 psr-4 共存时的匹配逻辑
当一个类名同时可能命中 classmap 和 psr-4 规则时，Composer 会先查 classmap（更快），命中即返回；未命中才 fallback 到 psr-4 拼路径 + file_exists() 判断。
这意味着：如果你把 LegacyUser.php（无命名空间）放进 "classmap": ["legacy/"]，又同时在 psr-4 里配了 "Legacy\": "src/Legacy/"，那么 new LegacyUser() 会走 classmap，new LegacyUserManager() 才走 PSR-4。
- classmap 必须运行
composer dump-autoload -o或composer install --optimize-autoloader才能扫描并生成映射；仅改composer.json不执行命令，新增类永远找不到 - psr-4 命名空间前缀必须以
\结尾（如"App\"），路径值末尾不能带/（如"src"✅，"src/"❌）；错一处，整个前缀规则静默失效 - 多个 psr-4 映射共存时，更长的前缀要写在前面，例如
"App\Http\": "src/Http/"必须在"App\": "src/"之前，否则App\Http\Controller会被宽泛规则截断为Http\Controller，路径拼错
autoload-dev 中的 files 是否影响主加载器
不影响。所有 autoload-dev 下的配置（包括 files、psr-4、classmap）只在 require-dev 已安装、且未使用 --no-dev 时才被注入主 autoloader。它们和主 autoload 是两套独立映射。
常见错误现象：本地跑测试没问题，CI 报 Class 'Tests\TestCase' not found —— 很可能 CI 命令用了 composer install --no-dev --no-interaction，导致 autoload-dev 完全不生效。
- 不要把测试辅助函数塞进主
autoload.files，否则上线包会多带一堆测试代码，增大部署体积 -
autoload-dev.files中的文件，同样受“路径必须相对于composer.json”限制；写成"tests/helpers.php"✅，写成"helpers.php"❌（当前工作目录不可控） - 如果测试类依赖主 autoload 的类，确保主 autoload 已正确定义；
autoload-dev不会帮你补全主 autoload 的缺失
真正容易被忽略的是：所有 autoload 配置都只影响 vendor/autoload.php 的生成结果，改完 composer.json 不运行 composer dump-autoload 或 composer install，等于什么都没做；而一旦用了 --optimize-autoloader，就必须保证 classmap 覆盖全部运行时类，否则开启 --classmap-authoritative 会直接报错而非 fallback。
