vendor/autoload.php 是 Composer 自动加载机制的启动器，必须在入口文件首行显式引入；它通过 spl_autoload_register() 注册加载器、载入 PSR-4/classmap 映射、预加载 files 列表，缺一则自动加载静默失效。
vendor/autoload.php 不是“加载器”而是“启动器”
它本身不包含任何类加载逻辑，只干三件事：调用 spl_autoload_register() 注册真正的加载函数、载入 PSR-4 / classmap 映射表、立即 require_once 配置里的 files 列表。跳过它，等于没点火就踩油门——类根本不会触发自动加载。
- 必须在入口文件（如
index.php）第一行显式写require_once 'vendor/autoload.php';，否则整个 autoload 机制静默失效 - 它内部只有一行实质调用：
return ComposerAutoloaderInitXXX::getLoader();，所有加载逻辑都在vendor/composer/autoload_real.php和映射文件里 - 删掉或注释这行，哪怕类文件路径完全正确，也会直接报
Fatal error: Uncaught Error: Class 'X' not found
PSR-4 映射不是“智能猜路径”，而是机械字符串替换
Composer 不扫描目录，也不递归查找；它只按 composer.json 里写的前缀做截断+拼接。命名空间和目录结构必须严格对齐，差一个反斜杠、一个大小写、一个层级，就找不到文件。
- 配置
"App\": "src/"→ 类AppModelsUser必须对应src/Models/User.php，不是src/User.php也不是src/models/user.php -
src/结尾必须带斜杠，写成"src"或"/src/"都会导致路径拼错 - 命名空间末尾的反斜杠是必需的：
"App\"正确，"App"会因转义失败导致匹配失效 - 改了类名、移动了文件、更新了
autoload配置，必须运行composer dump-autoload，否则autoload_psr4.php还是旧映射
classmap 和 files 各有不可替代的用途
别把它们当 PSR-4 的备选方案，它们解决的是完全不同维度的问题。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
classmap：适合无命名空间的老代码、第三方库、或你明确想用 O(1) 查找加速的场景；执行composer dump-autoload -o或配置"optimize-autoloader": true才会生成autoload_classmap.php -
files：只用于加载纯函数、常量、全局配置等无class声明的 PHP 文件；写进"files": ["src/helpers.php"]后，每次引入autoload.php就会无条件执行一次，不能用来加载类 - 混用时，加载器按 classmap → PSR-4 → PSR-0 → files 顺序尝试，命中即止；但
files是“预加载”，不参与“按需加载”流程
为什么 new X() 报错，却查不到文件在哪？
大概率不是路径错了，而是 autoload 根本没注册，或者注册了但没命中任何映射规则——引擎连文件是否存在都没去判断。
立即学习“PHP免费学习笔记（深入）”；
- 先确认是否真的
require_once 'vendor/autoload.php'了（检查有没有拼错路径、有没有被条件语句包裹） - 再检查
composer.json的autoload是不是写在了autoload-dev里，而你在非开发环境运行 - 用
composer show --platform或直接打开vendor/composer/autoload_psr4.php，看映射数组里有没有你期望的前缀 - Windows 下尤其注意大小写：
Src/和src/是两个目录，但 PHP 可能不报错，只默默跳过
