vendor/autoload.php 是 composer 自动加载机制的轻量级引导入口，仅负责引入 autoload_real.php、调用 getloader() 注册 classloader 实例并返回；它本身不包含业务类、不解析路径、不扫描文件，也非可编辑的配置文件。
Composer 自动生成的类文件（如 vendor/autoload.php）本身不包含任何业务类，它只是自动加载机制的“调度入口”——真正起作用的是背后由 Composer 构建并缓存在 vendor/composer/ 下的映射表和 ClassLoader 实例。
vendor/autoload.php 是什么，又不是什么
vendor/autoload.php 是一个轻量级引导文件，它不做路径解析、不扫描文件、不读取命名空间，只做三件事：引入 autoload_real.php，调用 ComposerAutoloaderInit 的 getLoader()，返回一个已注册好 spl_autoload_register() 的 ClassLoader 对象。
它不是你该修改的文件，也不是类定义的容器。所有手动编辑 vendor/autoload.php 的行为，都会在下次 composer install 或 composer dump-autoload 时被覆盖。
- 它不“知道”你的类在哪——那是
vendor/composer/autoload_psr4.php和autoload_classmap.php的职责 - 它不处理大小写校验——PHP 自动加载器原生区分大小写，Linux 下
Usercontroller.php和UserController.php就是两个文件 - 它不支持运行时动态增删映射——所有映射必须在生成时固化，改了
composer.json就得重跑命令
PSR-4 映射怎么拼出真实路径
PSR-4 不是模糊匹配，而是严格字符串替换+目录拼接。给定配置 "App": "src/" 和类名 AppControllerUserController，Composer 执行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
1. 去掉命名空间前缀 App\ → 得到 ControllerUserController
2. 把反斜杠 替换为目录分隔符 / → 得到 Controller/UserController
3. 拼上基础路径 src/ 和后缀 .php → 最终路径 src/Controller/UserController.php
这个过程对大小写、反斜杠数量、路径结尾斜杠都敏感：
-
"App": "src/"（缺末尾反斜杠）→ 前缀匹配失败，AppFoo会被当成完整命名空间，找不到文件 -
"App\": "src"（路径缺末尾斜杠）→ 拼成srcController/UserController.php，路径错误 -
namespace AppController;写在src/Controller/UserController.php里 → 实际命名空间是AppController，不是AppController，无法匹配
为什么 dump-autoload 后类还是找不到
最常见原因不是配置错，而是加载时机或环境不一致：
- 没在脚本开头
require 'vendor/autoload.php'—— 自动加载器根本没注册，new会直接报Class not found - 执行
composer dump-autoload时不在项目根目录 —— 它只读当前目录下的composer.json，可能误用了父级或子级项目的配置 - 用了
--no-scripts或 CI 环境跳过了 autoload 生成步骤 ——vendor/autoload.php可能是旧版，映射未更新 - 开发中启用了 OPCache 且未清理 —— 即使文件已更新，PHP 还在用缓存的
autoload_psr4.php，需执行opcache_reset()或重启 PHP-FPM
优化 autoload 的实际影响点
composer dump-autoload -o 的核心动作是把 PSR-4 映射“扁平化”进 autoload_classmap.php，让加载器跳过字符串替换和目录遍历，直接查表。但它有明确适用边界：
- 适合类数量多、命名空间层级浅、文件变动少的生产环境；开发期频繁增删类时，-o 反而增加生成耗时
- 不会提升单次加载速度的“感知”，但能降低高并发下路径拼接与
file_exists()的系统调用开销 - 启用后，
autoload_psr4.php仍存在，但ClassLoader会优先走 classmap；若某类不在 classmap 中（比如新添未 dump 的），仍会 fallback 到 PSR-4 规则 - 搭配
"optimize-autoloader": true写入composer.json后，所有composer install/update默认生效，无需每次加-o
真正容易被忽略的，是 PSR-4 路径拼接那几行代码——它不报错、不警告，只静默失败。确认类找不到时，先盯住命名空间声明、文件路径、composer.json 配置三者的字符级一致性，比查文档快得多。
