Composer自动加载靠require vendor/autoload.php启动预注册链，而非__autoload；该文件必须首行引入，否则类实例化时因未注册加载器而报错。
Composer 自动加载不是靠 PHP 内置的 __autoload 或 spl_autoload_register 单点注册实现的，而是靠显式 require vendor/autoload.php 启动一整套预注册的加载链，核心是 PSR-4 映射表 + ClassLoader 实例 + spl_autoload_register 回调绑定。
为什么 require 'vendor/autoload.php' 必须写在入口文件第一行
因为 vendor/autoload.php 的作用不是“定义类”，而是执行注册动作：它会立即调用 ClassLoader::getLoader()，内部通过 spl_autoload_register() 把多个加载逻辑（PSR-4、classmap、files）挂进 PHP 的自动加载队列。如果这行代码被放在 new AppController() 后面，PHP 在实例化时已触发 autoload 队列，但此时还没注册任何 handler，直接抛 Class not found —— 不报错原因，是 autoload 队列为空，PHP 默认不处理。
常见错误现象：
- 入口文件里先 new 一个类，再 require autoload → 必定失败
- 框架启动前用了
set_include_path()或自定义__autoload，且返回 false → 拦截了后续 Composer 加载器 - CLI 脚本里漏掉这行，却在测试中“偶然”跑通（因其他依赖已提前加载过该类）→ 具有迷惑性
PSR-4 映射表从哪来、怎么生效
映射数据不在 vendor/autoload.php 里，而在 vendor/composer/autoload_psr4.php 这类生成文件中。它本质是一个 PHP 数组，形如：['App\' => ['src/']]。每次执行 composer dump-autoload，Composer 就扫描 composer.json 中 autoload.psr-4 字段，把命名空间前缀和路径硬绑定，生成这张表。
关键约束：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 命名空间必须以反斜杠结尾，写成
"App"或"App\"（双反斜杠是字符串转义，实际值仍是单反斜杠）都合法；但写成"App"（无反斜杠）就完全不匹配 - 路径末尾必须带斜杠，
"src"和"src/"在拼接时行为不同：src/Controller/Home.phpvssrcController/Home.php - 类名
AppControllerHome剥离前缀App\后得ControllerHome，再按\替换为/得Controller/Home，最后拼上src/→src/Controller/Home.php - 文件名必须与末级类名严格一致，
Home.php里不能定义class home（Linux 下大小写敏感）
改了 composer.json 或加了新类，为什么还是 Class not found
根本原因是映射表没更新。你改的是配置源，不是运行时数据。vendor/autoload.php 只是启动器，真正干活的是它加载的 autoload_psr4.php 等文件 —— 它们不会监听文件变化，只在 composer dump-autoload 时重写。
典型误操作：
- 编辑完
composer.json，直接刷新页面 → 映射仍是旧的，找不到新类 - 开发中新增
AppServiceLogger并放到了src/Service/Logger.php，但忘了运行composer dump-autoload - CI/CD 流水线用
composer install --no-dev，而新类写在autoload-dev里 → 构建环境压根不生成对应映射 - 手动修改过
vendor/composer/autoload_psr4.php→ 下次dump-autoload会被覆盖，白改
classmap、files 和 PSR-4 混用时谁优先
没有“优先级”一说，是并行注册的多个 spl_autoload_register 回调函数，PHP 按注册顺序依次调用，直到某个成功加载文件为止。Composer 默认按此顺序注册：files → classmap → PSR-4。
这意味着：
-
files是无条件预加载，适合全局函数或常量定义，但会拖慢启动速度 -
classmap是全路径硬编码映射（['MyLegacyClass' => '/path/to/old.php']），适合类名/文件名不一致的老代码，执行最快但不支持动态增删 -
PSR-4是动态路径推导，灵活但有开销；开发阶段建议不用-o，避免 classmap 固化导致新增类不生效 - 如果一个类同时出现在
classmap和PSR-4映射中，先注册的classmap会先命中，后面 PSR-4 就不会执行
最易被忽略的一点：所有这些机制都依赖 vendor/autoload.php 被正确引入。它不是“配置文件”，是启动开关；它也不是“你的代码”，是 Composer 自动生成的胶水——改它没用，删它就全崩。
