PSR-4映射必须严格匹配:命名空间前缀写为"App": "src/"(双反斜杠+路径尾斜杠),目录结构、文件名大小写、类名首字母大写须完全一致,修改后必须执行composer dump-autoload生效。

配对了就能自动加载,配错了就报 Class not found —— Composer 的 PSR-4 映射不是智能推断,是严格字符串匹配,错一个反斜杠、少一个斜杠、大小写不一致,类就找不着。
composer.json 里 psr-4 的键值怎么写才对
命名空间前缀必须以双反斜杠结尾(JSON 里写成 "App\"),路径值必须以正斜杠结尾("src/"),两者都不可省略或写错:
-
"App\": "src/"✅ 正确:双反斜杠表示字面量反斜杠,路径末尾有斜杠 -
"App": "src/"❌ 错误:单反斜杠在 JSON 中会转义后续字符,解析失败 -
"App": "src/"❌ 错误:没反斜杠,匹配不到AppHttpController这类完整命名空间 -
"App\": "src"❌ 错误:路径缺末尾斜杠,Windows 下尤其容易导致 IDE 跳转失效
类文件路径和 namespace 声明必须完全对齐
PSR-4 不做任何转换或容错,只做机械拼接:namespace AppHttpControllers; + class UserController → 自动去找 src/Http/Controllers/UserController.php:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 大小写必须一致:
AppHttpControllers≠appHttpControllers - 目录结构必须存在:
src/Http/Controllers/目录得真实存在,不能靠 IDE 自动生成 - 类名不能含下划线:
User_Controller不走 PSR-4,得用classmap或改名 -
use AppHttpControllersUserController;才能生效;写成use AppHttpControllerUserController;就会找不到
改完 composer.json 后为什么类还是加载不了
配置只是声明,不执行命令就不会生效。常见遗漏步骤:
- 没运行
composer dump-autoload:配置只写进去了,但 vendor/autoload.php 没更新 - 用了优化模式但没加
-o:composer dump-autoload -o才生成 classmap 缓存,开发中可先不用,但上线前必须加 - IDE 缓存没刷新:PHPStorm/VS Code 可能还索引着旧路径,需手动 Reload project 或 Invalidate Caches
- 同时存在
psr-0、classmap或files配置,且有冲突:优先移除非必要 autoload 类型,只留psr-4
为什么 IDE 提示“Undefined class”但代码能跑通
这是映射配置和 IDE 索引不同步的典型表现,不是 Composer 加载失败:
- 确认
composer.json中psr-4的命名空间结尾是"App\",不是"App"或"App" - 检查项目根目录下是否存在对应路径,比如
src/是否真被映射为App\的起点 - PHPStorm 中右键项目 →
Composer→Reload project;VS Code 安装并启用PHP Intelephense插件后,按Ctrl+Shift+P→Intelephense: Index workspace - 别忽略大小写敏感性:Linux/macOS 下
src/http/Controllers和src/Http/Controllers是两个路径
最常被跳过的其实是路径真实性验证和 IDE 索引刷新——很多人反复改 composer.json 却不确认目录是否存在、不点 reload,最后以为是 Composer 问题,其实只是文件没放对地方或者编辑器没看到新规则。

















