require 'vendor/autoload.php' 必须放在入口文件第一行，因为它是通过spl_autoload_register()注册PSR-4、classmap等加载逻辑的唯一入口，若类实例化（如new AppControllerHome）发生在注册前，PHP因无可用加载器直接抛Class not found错误。
require 'vendor/autoload.php' 必须放在入口文件第一行，否则类一定加载失败——这不是建议，是机制硬约束。
为什么 require 'vendor/autoload.php' 必须写在最前面
这行代码不定义任何类，只做一件事：调用 ClassLoader::getLoader()，把 PSR-4、classmap、files 三类加载逻辑通过 spl_autoload_register() 注册进 PHP 的自动加载队列。PHP 在实例化类（如 new AppControllerHome()）时会立刻触发 autoload 队列；如果此时还没注册 handler，队列为空，直接抛 Class not found 错误。
常见踩坑点：
- 入口文件里先
new AppController()再require 'vendor/autoload.php'→ 必定失败 - 框架启动前调用了
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"（无反斜杠）完全不匹配 - 路径末尾必须带正斜杠：
"src/"正确，"src"会导致拼成srcController/Home.php而非src/Controller/Home.php - 类名
AppControllerHome剥离前缀后得ControllerHome，再把替换为/→Controller/Home，最后拼上src/→src/Controller/Home.php - 文件名必须与末级类名严格一致（Linux 下大小写敏感）：
Home.php里只能定义class Home，写成class home或文件叫home.php就加载失败
改了 composer.json 或加了新类，为什么还是 Class not found
根本原因是映射表没更新。你改的是配置源，不是运行时数据。vendor/autoload.php 只是启动器，真正干活的是它加载的 autoload_psr4.php 等静态映射文件——它们不会监听变化，只在 composer dump-autoload 时重写。
典型场景：
- 新增了
src/Service/Logger.php？不执行composer dump-autoload，映射表里就没有这条记录，必然Class not found - 把
"App\": "src/"改成"App\": "app/"？不执行命令，旧映射仍指向src/，所有类都加载失败 - 删掉
vendor/autoload.php后运行composer install，它会立刻重建——但重建依据仍是当前composer.json和已存在的源码结构
vendor/autoload.php 是怎么来的、能不能手写
vendor/autoload.php 是 composer install 或 composer update 时自动生成的入口文件，它本身不包含任何类路径逻辑，只做一件事：引入 vendor/composer/autoload_real.php 并调用 ComposerAutoloadClassLoader::getLoader()。
不能手写替代，原因很实在：
- 手动复制别人项目的
autoload.php过来，大概率报错——因为里面引用的autoload_psr4.php等路径是相对生成时环境硬写的 - 它不读取
composer.json运行时，只加载vendor/composer/下已生成的 PHP 映射表 - 它不解析代码，只做路径推导和字符串拼接；不验证类是否存在、不检查文件名是否匹配类名、不运行任何用户代码
最易被忽略的一点：映射表生成靠正则提取 namespace 声明，不是 require 文件后反射获取——所以哪怕你写了合法 namespace 却忘了保存文件，composer dump-autoload 也看不到它。
