Composer autoload映射需执行dump-autoload生效，PSR-4键名必须以双反斜杠结尾如"App": "src/"，路径值须为相对目录且推荐带尾部斜杠，子命名空间严格按目录结构对齐，映射与文件系统强绑定。
Composer 的 autoload 映射不是“写完就生效”，而是必须经过 composer dump-autoload 编译进 vendor/composer/autoload_psr4.php 才真正起作用；配错一个反斜杠、路径大小写不一致、或目录不存在，都会直接导致 Class not found，且错误里不会提示映射问题。
psr-4 键名必须以双反斜杠结尾
PHP 字符串中单个 是转义符，所以 "App": "src/" 才表示命名空间前缀 App；写成 "App": "src/" 会被解析为字面量 App（无反斜杠），匹配逻辑降级或完全失效。
-
"App": "src/"✅ 正确：实际前缀是App -
"App": "src/"❌ 错误：PHP 解析为字符串App，不匹配任何以App开头的类名 -
"App\": "src/"⚠️ 看似冗余，但等价于"App": "src/"，可读性差，不推荐
路径值必须是相对路径且末尾建议带斜杠
值字段是相对于 composer.json 所在目录的路径，不能以 / 开头，也不能是绝对路径；末尾加 /（如 "src/"）虽非强制，但能避免与同名文件冲突，新版 Composer 和 CI 环境更倾向报警告。
-
"src/"✅ 推荐：明确指向目录 -
"src"⚠️ 危险：若项目根目录下恰好有src文件（非目录），dump-autoload不报错，但运行时找不到类 -
"/src/"❌ 绝对路径写法，Composer 直接忽略该条映射 -
"./src/"❌ 不合法，Composer 不支持.开头的相对路径
子命名空间必须靠目录结构硬对齐
PSR-4 不扫描子目录，也不模糊匹配；它只做确定性拼接：截掉前缀后，把剩余命名空间段中的 替换为 /，再拼到映射路径后。差一级目录、少一个 、大小写不一致，全部失败。
- 映射
"App": "src/"+ 类名AppHttpClient→ 查找src/Http/Client.php - 实际文件是
src/http/client.php→ Linux/macOS 下加载失败（路径大小写敏感） - 命名空间写成
appHttpClient→ 前缀不匹配App，跳过该规则 - 类文件叫
client.php但类名为Client→ PSR-4 不读文件内容，只按命名规则找文件
改配置后不跑 dump-autoload 就等于没改
vendor/composer/autoload_psr4.php 是静态快照，内容只取决于上次 dump-autoload 时的 composer.json 和磁盘状态；composer install 或 update 可能顺带触发，但不可依赖。
- 新增
"Utils": "lib/utils/"→ 必须手动执行composer dump-autoload - 本地开发用默认模式（不加
-o），改类文件不用重 dump - 生产部署用
composer install --no-dev --optimize-autoloader，它会生成优化版映射并校验 lock 文件 - 仍报错？先检查
autoload_psr4.php里有没有你新加的键，再确认对应目录真实存在
最常被忽略的一点：PSR-4 映射和文件系统是强绑定的——它不验证路径是否存在，也不递归扫描，只机械拼路径、然后 is_file()。所以 src/Controllers/UserController.php 缺一个 s，或者 Controllers 实际叫 controllers，错误永远卡在 “Class not found”，而不是 “映射未命中”。
