PSR-4自动加载需在composer.json的autoload中显式声明，键为带尾部反斜杠的命名空间前缀（如"App\\": "src/"），值为项目根目录下的相对路径；配置后须运行composer dump-autoload生效，且文件名、命名空间、目录结构三者必须严格一致。
PSR-4 自动加载配置写在 composer.json 的 autoload 里
Composer 不会自动识别目录结构来推断命名空间，必须显式声明。核心是 "autoload": { "psr-4": { ... } } 这一段，键是命名空间前缀（含末尾反斜杠），值是相对于项目根目录的源码路径。
常见错误：漏掉命名空间末尾的 \，比如写成 "App": "src/" 而不是 "App\\": "src/" —— 这会导致 App\Http\Controller 类无法被找到，因为 Composer 会尝试加载 src/Http/Controller.php，但实际期望的是 src/Http/Controller.php 对应 App\Http\Controller，而前缀不带 \ 时匹配逻辑会错位。
-
"App\\": "src/"→ 正确：类App\Http\Controller映射到src/Http/Controller.php -
"App": "src/"→ 错误：可能匹配到src/App/Http/Controller.php，且与 PSR-4 规范不符 - 路径值不支持通配符或相对上层路径（如
"../lib/"），必须是项目根下的有效子路径 - 修改后必须运行
composer dump-autoload（或composer install/update）才能生效
多个命名空间怎么共存？用数组键值对逐条声明
一个项目常有主代码、测试、可选模块等不同命名空间，全部平级写在 psr-4 对象中即可，Composer 会按顺序尝试匹配（但实际是哈希查找，顺序无关）。关键是路径不能重叠，否则可能引发意外交互。
例如 Laravel 风格结构：
"autoload": {
"psr-4": {
"App\\": "app/",
"Database\\Factories\\": "database/factories/",
"Database\\Seeders\\": "database/seeders/"
}
}
- 每个键必须是合法命名空间 +
\\，不能是空字符串或纯数字 - 路径值建议以
/结尾（虽非强制），避免和同名文件冲突（如"App\\": "app"可能误匹配app.php） - 测试代码通常单独配置：
"Tests\\": "tests/"，并在autoload-dev中声明，防止发布时带上测试类
composer dump-autoload -o 是什么？它不解决 PSR-4 配置错误
-o（optimize）只是把 PSR-4 映射表预生成为静态数组，加快类加载速度，**不会修正路径或命名空间拼写错误**。如果配置本身有问题，加 -o 后反而更难调试——因为错误信息会被优化后的加载器掩盖，报错可能变成 “Class not found” 而非明确的路径提示。
- 开发阶段建议不用
-o，保持动态映射便于调试 - 生产部署时加
-o有意义，但前提是composer.json配置已验证无误 - 执行后生成的
vendor/composer/autoload_psr4.php是纯 PHP 数组，可直接查看映射关系，适合排查为什么某个类没被扫到
类文件名和命名空间不一致？Composer 不校验，但 PHP 会失败
PSR-4 只规定“命名空间前缀 + 子命名空间 = 目录路径”，不强制文件名必须和最终类名一致——但 PHP require 时仍需加载正确文件。也就是说，App\Http\Controller 必须定义在 src/Http/Controller.php，且该文件内必须有 class Controller；如果写成 class UserController，即使路径对了，运行时仍报 Class 'App\Http\Controller' not found。
- 文件名必须和类名完全一致（大小写敏感），这是 PHP 本身的限制，不是 Composer 的问题
- 嵌套命名空间层级必须严格对应目录深度，
App\Models\User→src/Models/User.php，不能是src/models/user.php（Linux 下路径不匹配） - Windows 开发者容易忽略大小写问题，建议在 CI 或本地 git hook 中加入检查，比如用
composer validate --strict辅助发现潜在不一致
autoload_psr4.php 和真实文件系统路径才能定位。 
