PSR-4自动加载不报错的关键是命名空间前缀末尾必须带双反斜杠（如"App\": "src/"），路径为相对于composer.json的以/结尾的相对路径，且类文件路径、命名空间声明、文件名三者严格一致。
composer.json 里 autoload 的 psr-4 怎么写才不报错
PSR-4 自动加载失效，90% 是因为命名空间前缀和路径没对齐。Composer 不校验你写的路径是否存在，也不检查文件是否真有对应类，只机械地把命名空间转成路径拼接——所以 autoload 写错，composer dump-autoload 会成功，但运行时直接 Class not found。
实操建议：
- 命名空间前缀末尾必须带反斜杠，比如
"App\": "src/"，不能写成"App": "src/"（否则AppController会被映射到src/Controller.php，而不是预期的src/Controller.php） - 路径必须是相对于
composer.json所在目录的相对路径，且以/结尾（如"src/"），否则 Composer 可能拼出srcFoo/Bar.php - 如果项目有多个命名空间，每个前缀都要独立声明，不能合并：
"App\": "src/"和"Tests\": "tests/"要分开写，不能写成"App\": "src/", "Tests\": "tests/"（语法虽合法，但易读性差，且容易漏逗号）
为什么 vendor/autoload.php 包含后还是找不到类
常见现象：执行 require 'vendor/autoload.php'; 后，new 一个自定义类就报 Class 'AppControllerHome' not found。问题往往不在 require，而在类文件本身或自动加载规则未生效。
排查步骤：
- 确认类文件路径是否与命名空间严格匹配：比如
AppControllerHome必须放在src/Controller/Home.php，且文件里第一行是namespace AppController; - 确认已运行
composer dump-autoload（开发中改了composer.json或加了新文件，这步不能跳） - 确认没有缓存干扰：如果用过
composer install --optimize-autoloader，改完规则后要重跑，否则优化后的 classmap 会覆盖 PSR-4 规则 - 用
composer show -p查看当前生效的 autoload 配置，确认你的规则在输出里
psr-4 和 classmap 混用时要注意什么
classmap 优先级高于 PSR-4，一旦某个类被 classmap 收录（比如通过 "classmap": ["legacy/"]），即使它也符合 PSR-4 规则，Composer 也会走 classmap 路径——这在迁移旧代码时容易导致“类突然找不到了”。
关键点：
- classmap 是静态扫描生成的，不会随文件增删自动更新；PSR-4 是运行时动态解析，更灵活但略慢
- 如果 legacy 目录下有个
Utils.php定义了AppUtils，而src/下也有同名命名空间，classmap 会抢先命中，PSR-4 规则被跳过 - 调试时可用
composer dump-autoload -v查看 classmap 扫描了哪些文件，避免意外覆盖
测试 autoload 是否生效的最小验证法
别等整个项目跑起来再试，用两行代码快速验证：
php -r "require 'vendor/autoload.php'; var_dump(class_exists('App\Controller\Home'));"
返回 bool(true) 才算通。如果返回 false，说明路径、命名空间、文件名三者至少有一处没对上。
注意细节：
- 类名里的双反斜杠
\是 PHP 字符串转义要求，实际命名空间声明里写的是单，但传给class_exists()必须双写 - 文件扩展名必须是
.php，Composer 默认不识别.inc或其他后缀 - Linux/macOS 下路径区分大小写，
src/controller/Home.php对应AppControllerHome，但写成app/controller/Home.php就失败
最常被忽略的是命名空间声明里的空格和换行——namespace AppController ; 末尾多了一个空格，PHP 解析会出错，但 Composer 不报，类就是加载不到。
