psr-4生效需命名空间、目录路径、文件名、composer.json配置、composer dump-autoload命令五者严丝合缝；任一环节错位即class not found，且错误不提示具体断点。
要让PHP项目真正用好PSR-4，关键不是“写对命名空间”，而是让命名空间、目录路径、文件名、composer.json配置、加载命令这五者严丝合缝。漏掉任一环，就会报Class not found——而错误提示从不告诉你哪一环断了。
目录结构与命名空间必须逐字符对齐
PSR-4不做模糊匹配，只做字符串替换。比如你配了"App\": "src/"，那么：
- namespace AppHttpControllers; → 必须对应 src/Http/Controllers/（注意大小写：Http ≠ http）
- 类名 HomeController → 文件必须叫 HomeController.php（不能是 homecontroller.php 或 Controller.php）
- 文件里第一行必须是 namespace AppHttpControllers;，不能有前导空格或tab，也不能写成 apphttpcontrollers
- 路径中所有层级都必须真实存在，src/Http/Controllers/ 缺任何一级目录都会失败
composer.json 配置必须精准无误
autoload 是顶层字段，不能嵌套在 require 或 scripts 里。常见写法示例：
{
"autoload": {
"psr-4": {
"App\": "src/",
"Tests\": "tests/"
}
}
}
注意几个硬性要求：
- 命名空间后必须是双反斜杠："App\" ✅，"App" ❌，"App\"（JSON中一个反斜杠） ❌
- 路径推荐以正斜杠结尾："src/" ✅，"src" ❌（否则可能拼出 srcMyClass.php）
- 路径不能以 / 开头，不能含 .. 或绝对路径
- 多个映射可共存，但Composer按前缀长度降序匹配，长前缀优先
改完配置后必须手动刷新自动加载
vendor/autoload.php 只是入口注册器，真正起作用的是 vendor/composer/autoload_psr4.php。这个文件不会自动更新。
- 开发中执行：composer dump-autoload（不加 -o，便于暴露路径错误）
- 生产环境部署时可加 -o 生成优化版 classmap，但调试阶段别用
- 修改了命名空间、挪动了文件、新增了类，只要没运行这条命令，就一定加载不到
- CI/CD 中建议加 --no-dev，避免 autoload-dev 里的测试类混入生产环境
验证是否生效的最快方式
不要等 new 类时报错才排查。直接检查映射文件是否已写入：
- 运行：var_dump(include 'vendor/composer/autoload_psr4.php');
- 确认输出数组中包含类似 "App\" => ["src/"] 的键值对
- 再试一个简单类：new AppHttpControllersHomeController();，看是否仍报错
- 如果还错，重点检查文件是否存在、扩展名是不是 .php（Windows 下容易存成 .php.txt）、权限是否可读
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
