psr-4自动加载需同时满足三条件才生效：composer.json中autoload为顶层键且格式正确、命名空间前缀以双反斜杠结尾并路径严格对齐、执行过composer dump-autoload。
PSR-4 自动加载不会“配置完就工作”，它只在三件事都对的情况下才生效：composer.json 里 autoload 字段写对、类文件路径与命名空间严格对齐、执行过 composer dump-autoload。少一个环节，Class not found 就必然出现。
composer.json 的 autoload 字段必须是顶层键，且格式不能错
常见静默失效不是代码问题，而是 JSON 键名拼错了。比如把 autoload 写成 auto-load、autoloader 或塞进 require 里，Composer 直接忽略整段配置。
-
autoload必须和name、require并列，是 composer.json 的一级字段 - 命名空间前缀必须以双反斜杠结尾：
"App"✅，"App"❌，"App"❌（开头反斜杠非法） - 路径值必须是相对路径，且以正斜杠结尾：
"src/"✅，"src"❌，"../src/"❌ - 空字符串
""或单个反斜杠""是非法前缀，Composer 7+ 会拒绝安装
类文件路径必须和命名空间逐字符对齐
PSR-4 不扫描目录，只做字符串替换：剥离命名空间前缀后，把剩余部分的 全换成 /，再拼上配置里的路径。差一个大小写、多一层目录、类名和文件名不一致，就找不到文件。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
AppHttpControllersHomeController→ 剥离App后剩HttpControllersHomeController→ 转为Http/Controllers/HomeController.php→ 最终加载src/Http/Controllers/HomeController.php - 文件必须真实存在，且路径大小写完全一致：
src/Http/Controllers/≠src/http/controllers/ - 类文件名必须等于类名：
class HomeController→ 文件必须叫HomeController.php，不能是homecontroller.php或HomeController.inc - namespace 声明行不能有前导空格或 tab：
namespace AppHttpControllers;✅，namespace AppHttpControllers;❌
vendor/autoload.php 引入了，但类还是找不到？重点查这三处
引入 vendor/autoload.php 只是注册加载器，真正起作用的是 vendor/composer/autoload_psr4.php —— 这个文件不会自动更新，必须靠 composer dump-autoload 重写。
- 改完 composer.json 后没运行
composer dump-autoload，映射根本没进 autoload_psr4.php - 运行时提示
Directory does not exist，说明配置里的路径（如"src/"）在项目根目录下实际不存在 - 用
var_dump(include 'vendor/composer/autoload_psr4.php');直接看数组里有没有你配的键值对 - 类文件里有语法错误（比如 PHP 版本太低不支持属性类型声明、BOM 头导致 ParseError），autoload 会静默跳过该文件
多个 PSR-4 映射共存时的优先级和冲突风险
多个映射可以并列定义，但 Composer 匹配时按“最长前缀优先”。如果顺序写反，宽泛前缀可能截胡具体类。
- 正确示例：
"Tests\": "tests/"和"App\": "src/"可共存，互不影响 - 危险写法：
"A\": "src/a/"和"App\": "src/app/"—— 当加载AppController时，A会先匹配成功，导致路径拼成src/a/pp/Controller.php - 测试类建议单独配映射，不要混进主命名空间，避免污染和路径歧义
- 第三方包的 autoload 已由其自身 composer.json 定义，你的项目里无需、也不该重复映射
最容易被忽略的是：PSR-4 的“对齐”是字面量级别的——命名空间声明、文件路径、composer.json 配置三者之间，差一个反斜杠、一个大小写、一个斜杠，就彻底失效。它不报错，只沉默跳过。调试时别猜，直接看 autoload_psr4.php 里有没有你写的那条映射。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
