Composer项目根命名空间由PSR-4 autoload规则与目录结构共同决定；key必须以结尾，value为相对于composer.json的路径，修改后需执行composer dump-autoload生效。
Composer 项目根命名空间不是靠“配置”出来的，而是由 autoload 规则 + 目录结构共同决定的；直接改 "psr-4" 的键值对就能控制自动加载起点，但写错路径或漏掉末尾反斜杠会彻底失效。
psr-4 的 key 必须以
PSR-4 要求命名空间前缀（key）以反斜杠结尾，这是硬性规范。不加 会导致 Composer 认为这是完整命名空间名，后续类名拼接时出错。
-
"App\"✅ 正确：表示所有App*类从app/目录开始找 -
"App"❌ 错误：Composer 会尝试加载AppFoo而非AppFoo，类文件根本找不到 - 常见现象：
Class AppHttpControllersHomeController not found，但文件明明在app/Http/Controllers/HomeController.php
autoload 的 psr-4 value 必须是相对于项目根目录的相对路径
composer.json 中的 psr-4 映射值（即目录路径）是相对于 composer.json 所在位置（即项目根）的路径，不能写绝对路径，也不能写错大小写（尤其在 Linux/macOS 上）。
- 若项目结构是
src/MyApp/Service.php，且想用MyAppService，应写：{ "autoload": { "psr-4": { "MyApp\": "src/MyApp/" } } } - 路径末尾可加
/，但非必须；关键是和实际目录一致（如写成"src/MyApp"而目录叫src/MyApp/，Windows 可能侥幸通过，Linux 会失败） - 执行
composer dump-autoload后才生效，修改后不运行该命令等于没改
不要混用 psr-4 和 classmap 来“覆盖”根命名空间
有人试图用 classmap 把 app/ 下所有文件扫进去，以为能绕过 PSR-4 命名空间约束——这会让自动加载变慢、失去命名空间语义，且一旦有同名类（比如两个 Helper.php），就会冲突或静默覆盖。
-
classmap适合遗留代码或无法重命名的单文件类，不适合定义“根命名空间” - PSR-4 是唯一推荐方式；如果真要支持多入口点，应拆成多个 PSR-4 映射：
"autoload": { "psr-4": { "App\": "app/", "Tests\": "tests/" } } - 注意：Composer 不支持通配符命名空间，
"*\": "src/"是非法语法
最常被忽略的是 vendor/autoload.php 的引入时机——它只负责加载你声明的命名空间，不会自动识别任意 PHP 文件；哪怕文件放在 src/ 下，只要没被 PSR-4 映射覆盖，就不会被自动加载，报错时别急着怀疑 Composer 配置，先检查类名、文件路径、命名空间声明三者是否完全对应。
