psr-4自动加载生效需满足三要素：正确配置composer.json中”psr-4″键值对（如”app”: “src/app/”），路径以/结尾、命名空间双反斜杠转义；类文件位置与命名空间层级严格对应（appuser→src/app/user.php）；修改后必须执行composer dump-autoload。
composer.json 里怎么写 autoload 才生效
PSR-4 自动加载不是写完就跑，必须确保 composer.json 的 autoload 段结构正确，且执行过重载命令。常见错误是只改了配置但没运行 composer dump-autoload，或者路径映射漏了末尾反斜杠。
-
"psr-4"的值必须是 命名空间前缀 → 实际目录路径 的键值对，路径以/结尾（如"App": "src/App/"） - 命名空间末尾的
必须双反斜杠转义，PHP 里是转义符，JSON 里也需保持一致 - 路径是相对于
composer.json所在目录的相对路径，不能写成./src/App/或绝对路径 - 改完后一定要手动触发：
composer dump-autoload（开发中加-o可生成优化后的 classmap，但 PSR-4 不依赖它）
为什么 new AppUser() 还是报 Class 'AppUser' not found
绝大多数情况不是配置错，而是类文件位置或命名不匹配 PSR-4 规则：命名空间层级必须和目录层级完全对应，类名必须和文件名一致（含大小写）。
- 如果声明了
"App": "src/App/"，那么AppUser就必须落在src/App/User.php，而不是src/App/Models/User.php -
User.php文件内必须有Namespace App;，不能是namespace AppModels;（那得配成"AppModels": "src/App/Models/"） - linux/macos 下文件名大小写敏感，
user.php和User.php是两个文件，类名User只会去找User.php - 检查是否误把类放在
vendor/下——Composer 不会自动加载 vendor 里的自定义代码
开发时想边写边加载，又不想每次改都 dump-autoload
用 autoload-dev 配置开发专用路径，并配合 composer install --no-autoloader + 手动 dump 更可控；但最省事的是直接启用 classmap 扫描，适合小项目或原型阶段。
-
"classmap"支持直接扫目录（如["src/", "tests/"]），新增文件不用改配置，只要重新dump-autoload即可 -
autoload-dev专用于测试类，例如："autoload-dev": {"psr-4": {"Tests": "tests/"}}，这样composer install --no-dev时不会加载测试代码 - 不要在生产环境用
classmap扫全src/，它会把所有 PHP 文件都注册进 autoloader，哪怕没被用到，浪费内存
多个命名空间指向同一目录？别硬凑，用多条 PSR-4 映射
一个目录不能同时属于两个不同根命名空间（比如 App 和 Domain），强行共用会导致类名冲突或自动加载失败。正确做法是按语义拆分映射，哪怕目录物理上挨着。
- 错误写法：
"App": "src/", "Domain": "src/"→DomainUser会被去src/User.php找，但该文件大概率属于App命名空间 - 正确写法：按实际结构分，比如
"App": "src/App/", "Domain": "src/Domain/"，哪怕两个目录都在src/下一级 - 如果真要共享逻辑，用
use引入，而不是靠 autoload “偷懒”映射
PSR-4 看似简单，真正卡住人的往往是路径拼接时少了一个 /、命名空间里多打了一个空格、或者文件保存成了 UTF-8 bom 格式——这些细节不会报错，但会让类永远找不到。