PSR-4自动加载生效需同时满足三条件：composer.json映射正确、文件路径与命名空间严格对齐、执行composer dump-autoload；映射键须为双反斜杠结尾的命名空间前缀，值为相对composer.json的无前导/路径，推荐末尾加/；匹配按最长前缀优先，路径拼接为替换为/后加.php，三者必须严丝合缝。
PSR-4 自动加载不会“配完就跑”，必须同时满足三件事：composer.json 映射正确、文件路径与命名空间严格对齐、执行过 composer dump-autoload。
composer.json 里 "psr-4" 键值对怎么写才不报错
错误配置是 Class not found 的第一大来源。JSON 中的键是命名空间前缀，值是相对路径，二者都受 PHP 和 Composer 双重解析规则约束：
-
"App"必须写成双反斜杠（"App\"在 PHP 字符串中表示一个，JSON 里也需保持一致），写成"App"或"App/"都会破坏匹配逻辑 - 路径值如
"src/"是相对于composer.json所在目录的子路径，不能以/开头（"/src/"❌），也不能用./src/（./会被忽略） - 路径末尾加
/不是强制，但强烈推荐："src/"✅ 比"src"❌ 更安全，避免和同名文件冲突 - 映射必须是顶层
"autoload"字段下的直接子项，嵌套在"extra"或其他字段里完全无效
为什么 new AppHttpControllerHomeController() 还是报 Class 'AppHttpControllerHomeController' not found
这不是 autoload 没生效，而是 PSR-4 的路径拼接失败了。Composer 会把命名空间 AppHttpControllerHomeController 拆成前缀 App + 剩余部分 HttpControllerHomeController，再把 替换成 /，最后拼上 .php —— 得到 src/Http/Controller/HomeController.php。只要其中任一环节断开，就找不到类：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 文件实际在
src/Controllers/HomeController.php→ 目录名Controllers和命名空间里的Controller不一致（少了个s） - 文件名是
homecontroller.php或HomeController.php但类内部声明的是class homecontroller→ 大小写不匹配，Linux/macOS 下直接失败 -
HomeController.php文件里写的是namespace AppHttpControllers;，但映射只写了"App\": "src/"→ 命名空间剩余部分是HttpControllersHomeController，对应路径应为src/Http/Controllers/HomeController.php，不是src/Http/Controller/... - 运行
composer dump-autoload -o时没报错，不代表路径存在；如果src/目录根本不存在，它只会静默跳过，直到运行时才炸
多个命名空间共存时怎么避免互相干扰
多个 PSR-4 映射可以共存，但 Composer 匹配时按「最长前缀优先」，不是按 JSON 顺序。这容易引发意料外的覆盖：
- 若同时配置
"App\": "src/"和"App\Http\": "src/Http/"，后者永远不会被用到——因为AppHttpSomething同时匹配两个前缀，而App更短，先被截走 - 正确做法是删掉宽泛前缀，或把具体前缀放前面（虽然 JSON 无序，但 Composer 解析后会排序）：
"App\Http\": "src/Http/"和"App\": "src/"可共存，前提是前者更长 - 测试类建议用
"autoload-dev"单独配，比如"Tests\": "tests/"，这样composer install --no-dev就不会把它们打进生产 autoloader - 别让两个不同前缀指向同一物理目录（如
"App\": "src/"和"Domain\": "src/"）→ 类名冲突风险极高，且 Composer 不保证行为一致
怎么快速验证 PSR-4 配置是否真生效
别靠猜，直接看 Composer 生成的映射表。最可靠的方式是检查 vendor/composer/autoload_psr4.php 是否包含你预期的键值对：
- 临时在入口文件加一句：
var_dump(include 'vendor/composer/autoload_psr4.php');，看输出数组里有没有类似'App\' => array('/path/to/project/src/')的条目 - 运行
composer dump-autoload -v，留意是否有Warning: Directory does not exist—— 这说明路径写错了，但默认模式下它不报错 - 用
composer show --platform看当前 autoloader 是否加载了你的命名空间（需 Composer 2.2+） - 如果改了配置但
autoload_psr4.php没更新，一定是漏了composer dump-autoload，或者改错了文件（比如改了 vendor 里的 composer.json）
最常被忽略的一点：PSR-4 不扫描目录，它只做确定性字符串拼接。你写 "App\": "src/"，它就永远只拼 src/ 开头的路径，哪怕你把类扔进 lib/ 也没用。路径、命名空间、文件名，三者必须像齿轮一样严丝合缝，少一齿就卡死。
