PSR-4自动加载需在composer.json的autoload.psr-4中严格配置命名空间前缀（如"App": "src/"）与路径映射，修改后必须执行composer dump-autoload生成autoload_psr4.php查表文件，否则引入vendor/autoload.php也无法加载类。
PSR-4 自动加载不是“写完配置就自动生效”，它靠的是 composer.json 中声明的命名空间前缀与物理路径的**静态映射表**，运行时由 vendor/autoload.php 查表定位文件——改了配置不执行 composer dump-autoload，就等于没改。
PSR-4 映射怎么写才被 Composer 识别
必须写在 composer.json 的 autoload 字段下，用 psr-4 键，且满足三个硬性格式：
- 命名空间前缀末尾必须是
\（JSON 中写成"App\": "src/"），少一个反斜杠，整个映射会被忽略 - 路径值必须以
/结尾（如"src/"，不能是"src"或"./src/"） - 路径是相对于
composer.json所在目录的**真实可读路径**，大小写必须完全一致（src/Http/≠src/http/）
错误示例："App": "src"、"\App\": "src/"、"App\": "Src/" —— 这些都会导致 Class not found 且无明确报错。
为什么 vendor/autoload.php 引入了类还是找不到
引入 vendor/autoload.php 只是注册了自动加载器，能不能加载成功，取决于两个环节是否对齐：
-
vendor/composer/autoload_psr4.php里有没有你配的键（比如'App\' => array($baseDir . '/src')）——运行composer dump-autoload后手动打开这个文件确认 - 类文件路径是否严格按规则拼出来：类名
AppHttpControllerUserController→ 剥离前缀App\→ 剩余HttpControllerUserController→ 转为路径Http/Controller/UserController.php→ 最终加载src/Http/Controller/UserController.php - 文件内
namespace必须是AppHttpController;（不能多一级、不能少一级、不能大小写错） - 文件名必须是
UserController.php，且只定义class UserController
dump-autoload 不生效的常见原因
不是命令没跑，而是环境或配置卡在某个隐性环节：
- 修改了
composer.json但忘了运行composer dump-autoload（install或update不一定触发，尤其只改 autoload 时） - 路径配置错误但没报错：比如写了
"src/Utils/"，而实际目录是src/utils/，Composer 会静默跳过该映射 - 手动生成过
vendor/composer/autoload_psr4.php并做了修改，导致后续dump-autoload覆盖失败（这个文件应始终由 Composer 管理） - 用了
--no-dev但测试类放在了主autoload里，或反之——检查autoload-dev是否误配
最直接验证方式：var_dump(include 'vendor/composer/autoload_psr4.php');，看输出数组里有没有你的前缀键。
PSR-4 性能关键点：它不扫描，只查表
PSR-4 本身不涉及文件遍历或动态猜测，所有路径都是编译期确定的。但每次 new 类仍需：
- 调用
stat()检查文件是否存在 - 打开并读取 PHP 文件内容
- PHP 解析并编译该文件
这意味着：1000 个类 = 1000 次磁盘 I/O（HDD 上可能耗秒级）。所以开发中务必开 opcache，上线前用 composer dump-autoload -o 生成优化映射——它把所有类路径预生成到一张静态表里，跳过部分运行时拼接逻辑，但不会减少 include 次数。
真正容易被忽略的是：PSR-4 映射一旦写死，就和文件系统强绑定；重命名类、移动目录、改命名空间，三者必须同步，缺一不可。
