psr-4前缀映射必须严格匹配路径，如"app\": "src/"要求appcontrollerhomecontroller对应src/controller/homecontroller.php，映射错误会导致类找不到且dump-autoload不报错。
autoload psr-4 前缀映射必须写对路径，否则 composer dump-autoload 不报错但类找不到
PSR-4 映射不是“自动猜路径”，它严格按你写的字符串前缀 + 文件路径拼接来定位类。比如你声明 "App\": "src/"，那 AppControllerHomeController 就必须落在 src/Controller/HomeController.php，少一个目录、大小写错、文件名没加 php 后缀都会失败。
常见错误现象：Class AppControllerHomeController not found，但文件明明存在、composer dump-autoload 也执行成功了——问题几乎都在路径映射和实际文件结构不一致。
-
"App\": "src/"是推荐写法（末尾斜杠不能省，Windows 下也用正斜杠） - 前缀末尾的双反斜杠
\是必须的，代表命名空间分隔符，写成"App"或"App/"都会失效 - 路径是相对于
composer.json所在目录的，不是相对于项目根或vendor - 多个前缀可以并存，比如同时配
"App\"和"Tests\"，互不影响
修改 composer.json 后一定要运行 composer dump-autoload
改完 autoload 段不等于生效。Composer 不会在每次 require 时动态解析映射，而是生成 vendor/autoload_psr4.php 这个静态映射表。跳过这步，代码永远走不到你新配的路径。
使用场景：本地开发调测时，常有人改完 JSON 就直接跑 php index.php，结果还是旧逻辑；CI 环境如果只做 composer install 而没触发 autoload 重生成，也会复现同样问题。
- 开发中建议加
--optimize（即composer dump-autoload --optimize），生成更紧凑的映射数组，提升加载速度 - 如果用了
classmap或files类型 autoload，也要一起刷新，否则可能漏载 -
composer install和composer update默认会自动执行 dump，但纯修改配置后手动触发最稳妥
命名空间前缀里含 vendor 名（如 myvendor/app）要小心 Composer 的 autoload 自动发现机制
如果你的包准备发布到 Packagist，且用了类似 "MyVendorApp": "src/" 的前缀，注意 Composer 在安装时可能根据 name 字段（如 myvendor/app）自动补上 PSR-4 映射——这会和你手动写的冲突，导致重复注册或覆盖。
性能影响：重复映射不会报错，但会让 vendor/autoload_psr4.php 多出冗余条目，类加载时多一次数组查找；更麻烦的是，两个映射指向不同路径时，后注册的会覆盖先注册的，行为不可控。
- 检查是否被自动注入：运行
composer dump-autoload -v，看输出里有没有 “Generated autoload files…” 后列出的自动映射行 - 想禁用自动发现，加
"autoload": {"psr-4": {}, "classmap": []}并显式写出全部映射，空对象不等于无配置 - 私有包或 monorepo 场景下，建议始终显式声明，不依赖自动发现
测试 autoload 是否生效：用 composer show --platform 和 get_declared_classes() 辅助验证
光看 dump-autoload 成功不代表类真能加载。有些问题只在运行时暴露，比如命名空间大小写和文件系统敏感性（Linux 下 App/Controller ≠ app/Controller）。
可快速验证的方法：
- 运行
composer show --platform | grep autoload，确认autoload_psr4.php时间戳已更新 - 写个临时脚本：
- 如果返回
false，再用var_dump(get_declared_classes())看有没有其他App\*类被意外加载进来（比如测试文件或旧缓存干扰） - 别依赖 IDE 的自动补全结果——它可能从 stub 或缓存读取，不代表运行时真实状态
最容易被忽略的是文件系统大小写敏感性与开发环境不一致。Mac 默认不区分大小写，Linux 区分，同一套配置在本地能跑，上线就报错，这种坑得提前在 CI 用 Linux 容器验证。
