PSR-4自动加载需在composer.json顶层autoload字段正确定义命名空间与路径映射（如"App\": "src/"），并执行composer dump-autoload；文件路径、命名空间、类名须严格一一对应，大小写敏感，且不能混用classmap或files autoload。
composer.json 里怎么写 autoload 才生效
PSR-4 自动加载不会“自动生效”，必须在 composer.json 中正确定义命名空间与路径映射，并执行重生成操作。
常见错误是只改了代码文件结构，却忘了更新配置或没运行 dump-autoload；或者路径用了相对路径（如 ./src），但实际应写项目根目录下的相对路径（src/）。
-
"autoload"必须是顶层字段，不能嵌套在其他键下 - 命名空间末尾要加反斜杠，例如
"App\"，不是"App"或"App " - 路径值必须是相对于
composer.json所在目录的子路径，不支持../向上跳转 - 改完后一定要运行
composer dump-autoload（开发时可加-o生成优化版）
示例正确配置：
{
"autoload": {
"psr-4": {
"App\": "src/"
}
}
}
为什么 new App\User() 找不到类
绝大多数情况不是 PSR-4 写错了，而是文件路径和命名空间不严格匹配 —— PSR-4 要求“命名空间前缀 + 子命名空间”必须能一对一映射到“路径 + 文件名”。
比如 App\Http\Controllers\HomeController 对应的文件必须是 src/Http/Controllers/HomeController.php，大小写、目录分隔符、类名拼写都必须完全一致（Linux 环境区分大小写，Windows 下容易掩盖问题）。
- 文件扩展名必须是
.php，不能是.PHP或.php5 - 类名必须与文件名完全一致（
HomeController.php里只能定义class HomeController） - 如果用了子命名空间，中间目录名不能缺，也不能多出无关目录（如
src/App/Http/...是错的，因为命名空间已经是App\） - 检查是否误将类放在了
autoload-dev里，而当前环境未启用 dev autoload
composer dump-autoload 不生效的几个现实原因
命令看似跑完了，但类还是找不到，往往是因为缓存、权限或作用域问题，而不是命令本身失败。
- 使用了
vendor/autoload.php的脚本没有重新 require —— 改完配置后，已加载的 autoloader 不会自动刷新，得重启 CLI 进程或 Web 请求 - 某些 IDE 或调试工具（如 PHPStorm）自带类索引缓存，需手动刷新或清空 index
- 在 Docker 或容器中执行
composer dump-autoload，但应用运行在另一个容器里，vendor 目录未同步或挂载方式导致 autoload_files.php 没更新 - 权限问题：生成的
vendor/composer/autoload_psr4.php文件不可读（尤其在 CI 或部署脚本中 chown 错了用户）
生产环境要不要用 -o 参数优化 autoload
要用，但得知道它干了什么：开启 -o（--optimize）会让 Composer 把所有 PSR-4 映射预编译成一个静态数组，跳过运行时解析，提升类加载速度约 10%–30%，尤其对小类多的项目明显。
- CI/CD 部署时建议加
composer install --no-dev -o - 开发阶段不用强制加，因为每次改类都要重跑
dump-autoload -o，反而麻烦 - 注意：
-o不兼容动态注册的 autoloader（比如某些插件系统手动调spl_autoload_register），但纯 PSR-4 项目没问题 - PHP 7.4+ 开启 opcache 后，
-o带来的收益会减弱，但仍有可测差异
真正容易被忽略的是：很多团队写了 PSR-4 却没清理旧的 classmap 或 files autoload，导致加载逻辑混杂、优先级难判断。确认只保留一种机制，比怎么写更重要。
