PSR-4自动加载需手动配置composer.json的autoload字段，严格对齐命名空间、文件路径和类名，修改后必须执行composer dump-autoload生效。
PSR-4 映射写在 composer.json 里，不是命令生成的
PSR-4 自动加载根本不是“运行一个命令就自动配好”的功能——它完全依赖你手动编辑 composer.json 中的 autoload 字段。Composer 只负责读这个配置，然后生成 vendor/composer/autoload_psr4.php 这个静态映射表。没改配置、或改了没执行命令，new AppHttpControllerHome() 就一定报错。
-
autoload必须是composer.json的顶层字段，不能嵌在require或其他键下面 - 命名空间键必须以双反斜杠结尾：
"App\": "src/"✅，"App": "src/"❌（JSON 解析后变成无尾缀命名空间，匹配失败） - 路径值是相对于
composer.json所在目录的子路径，不支持../或绝对路径（如/var/www/src） - 路径末尾加不加
/不强制，但强烈建议加："src/"比"src"更安全，避免和同名文件冲突
为什么 new AppUser() 总是 Class not found
90% 的 “找不到类” 不是 Composer 配错了，而是三者没对齐：PHP 文件里的 namespace 声明、文件实际存放路径、composer.json 里的映射，必须严丝合缝——差一个字母大小写、少一级目录、多一个空格，都会失败。
-
namespace AppUser;→ 文件必须在src/User.php（单级命名空间） -
namespace AppHttpControllers;→ 文件必须在src/Http/Controllers/HomeController.php，且类名为HomeController - Linux/macOS 下
src/http/controllers/≠src/Http/Controllers/，Windows 开发也请严格保持大小写一致，否则上线即崩 - 类文件名必须和类名完全一致：
class ApiResponse→ 必须叫ApiResponse.php，不是apiresponse.php或ApiResponseController.php
composer dump-autoload 不是可选项，是必跑步骤
改完 composer.json 后，vendor/autoload.php 不会自动更新。它只加载 vendor/composer/autoload_psr4.php，而这个文件只有执行 composer dump-autoload 才会重写。
- 开发中用
composer dump-autoload -o（带-o即--optimize），生成静态 classmap，跳过运行时路径拼接和文件存在性检查，加载更快 -
composer install或update默认会触发 dump，但仅限于依赖变更；你自己加的映射，必须手动 dump - CI/CD 部署时建议固定用
composer install --no-dev --optimize-autoloader，避免本地未提交的 autoload 配置污染线上 - 如果仍报错，先运行
composer show --platform确认当前 autoloader 是否已包含你的新映射
测试类别混进主 autoload，是常见但危险的操作
把 Tests 命名空间配在主 autoload 里，看似省事，实则埋雷：测试类会被加载进生产环境，增加内存开销，还可能因依赖泄露（比如用了 PHPUnitFrameworkTestCase）导致线上 fatal error。
- 正确做法是用
autoload-dev单独配："autoload-dev": { "psr-4": { "Tests\": "tests/" } } -
composer install --no-dev时，autoload-dev内容不会写入最终的autoload_psr4.php - 别用
""或"\"当命名空间前缀——Composer 7+ 会直接拒绝安装，这是硬性校验，不是警告
dump-autoload，或者文件路径与命名空间之间有一个字符没对上。这种问题没法靠猜，只能三处并查：打开 PHP 文件看 namespace，看文件放在哪，再核对 composer.json 里写的映射——少一次比对，就多十分钟调试。 
