vendor/autoload.php 必须显式引入且置于入口文件首行，因其执行时通过spl_autoload_register()注册自动加载器，并依赖composer dump-autoload生成的PSR-4映射表（如autoload_psr4.php）；漏掉任一环节均导致Class not found。
vendor/autoload.php 不是“自动生效”的魔法文件，它必须被显式引入，且背后依赖 spl_autoload_register() + PSR-4 映射表驱动 —— 漏掉任一环节，类就加载失败，而且不报错，只抛 Class not found。
为什么 require 'vendor/autoload.php' 必须写在入口文件第一行？
因为 Composer 的自动加载靠的是 spl_autoload_register() 注册的回调函数；这个注册动作发生在 vendor/autoload.php 被执行时。如果它没被执行，或者被其他 autoloader（比如自己写的 __autoload）提前拦截并返回了 false，后续所有 PSR-4 类都找不到。
- PHP 在实例化一个未声明的类时，会依次调用所有已注册的 autoload 函数，直到某个函数成功
require到对应文件为止 -
vendor/autoload.php本身不包含类定义，只负责载入autoload_real.php并调用ClassLoader::getLoader() - 如果入口文件里先用了某个类，再
require autoload.php，那第一次类查找就已失败，PHP 不会“回溯重试”
PSR-4 映射表存在哪儿？改了类文件为啥不生效？
映射数据不在 vendor/autoload.php 里，而是在 vendor/composer/autoload_psr4.php（以及 autoload_classmap.php、autoload_files.php 等）这些生成文件中 —— 它们由 composer dump-autoload 命令重建。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 改了类的命名空间或文件路径后，必须运行
composer dump-autoload，否则旧映射仍指向错误位置 - 加了新类但没执行该命令？
Class not found就是结果，不是缓存问题，是映射表根本没收录它 - 用
composer dump-autoload -o可生成优化版（autoload_classmap.php），适合生产环境，但开发时建议不用-o，方便调试映射是否正确
手动 require 类文件 vs 自动加载：什么情况下会冲突？
混用两种方式极易导致类重复定义或加载顺序错乱，尤其在测试或插件场景下。
- 自己
require 'src/Helper.php'后，又通过 PSR-4 加载同名类，PHP 报Cannot declare class Helper - 某些框架（如 Laravel）会在服务提供者里动态 require 插件类，若插件目录也配置了 PSR-4，可能因加载顺序不同，导致类被加载两次或一次都没走对路径
- Windows 下注意路径分隔符：
str_replace('\', '/', $class)是 Composer 内部做的标准化处理，手写 autoload 时漏掉这步，跨平台就会失效
如何验证某个类是否被 autoload 正确收录？
别猜，直接查生成的映射文件，或用命令快速定位。
- 打开
vendor/composer/autoload_psr4.php，搜索你的命名空间前缀（如'App\' => array($baseDir . '/app')），确认路径拼接逻辑符合预期 - 运行
composer dump-autoload -v，它会打印“Generated autoload files…”及扫描到的类数量，异常时会提示“skipped”或路径不存在 - 临时在
ClassLoader::loadClass()里加var_dump($class, $file)（修改vendor/composer/ClassLoader.php），看实际尝试加载的路径是不是你预期的
真正容易被忽略的点是：autoload 不是“写完配置就完事”，它是一套生成式机制 —— 配置只是输入，dump-autoload 才是编译动作，而 vendor/autoload.php 只是运行时入口。三者缺一不可，且顺序不能颠倒。
