PSR-4映射必须严格对齐命名空间与目录结构：前缀末尾需双反斜杠，路径相对composer.json且推荐以/结尾，类名文件名须完全一致、大小写敏感；多映射时前缀不可重叠，改配置后须执行composer dump-autoload生效。
PSR-4 路径配不对，类就找不到——不是 Composer 不行，是你写的映射和文件结构没对齐。
psr-4 映射必须严格匹配命名空间与目录结构
Composer 不会“猜”你的类在哪，它只按规则拼路径：namespace App\Http\Controllers + "App\": "src/" → 就去找 src/Http/Controllers/ 下的文件。任何偏差都会失败。
- 命名空间末尾必须带双反斜杠：
"App\"✅，"App"❌（会被当转义） - 路径值是相对于
composer.json所在目录的，且推荐以/结尾（如"src/"），避免部分版本警告 - 类文件名必须与类名完全一致、大小写敏感：类
HomeController必须在HomeController.php，不能是homecontroller.php或Home_Controller.php - Linux 服务器上大小写错一个字母，直接
Class not found；Windows 开发时也别侥幸，提前对齐
多个 psr-4 映射怎么写才不冲突
可以同时定义多个，但前缀不能重叠，否则更宽泛的会“截胡”更具体的。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 错误写法：
"App\": "src/"和"App\Http\": "src/Http/"—— 后者永远不生效，因为App\已先匹配 - 正确顺序：
"App\Http\": "src/Http/"放前面，"App\": "src/"放后面 - 路径之间互不继承，
"App\": "src/"不代表"App\Services\"自动指向src/Services/，必须显式声明 - 测试类建议单独配：
"Tests\": "tests/"，别塞进"App\"里，否则上线包会多带测试代码
改完 composer.json 为什么还不生效
配置只是“原料”，composer dump-autoload 才是“加工”动作。不执行它，vendor/composer/autoload_psr4.php 就不会更新，autoload.php 加载的还是旧映射。
- 确保你在
composer.json所在目录下执行命令，不是子目录（比如在src/下运行无效） - 检查是否误用了
--no-dev：如果测试类放在autoload-dev里，CI 环境加了这个参数，Tests\命名空间就彻底不可用 - 临时验证映射是否写进去了：运行
php -r "var_dump(include 'vendor/composer/autoload_psr4.php');"，看输出数组里有没有你配的键 - 别手动改
vendor/composer/下的文件——下次composer install全被覆盖
什么时候该放弃 psr-4，改用 classmap 或 files
PSR-4 是规范路径的利器，但不是万能胶。遇到这些情况，硬套只会浪费时间。
- 老项目一堆
function helper_name()，没命名空间、文件名乱七八糟 → 用"classmap": ["legacy/", "utils/helpers.php"]，然后跑composer dump-autoload - 全局函数或常量定义（如
src/functions.php）→ 加到"files": ["src/functions.php"]，它会在每次请求时require_once，但注意别和其他地方重复包含 - 类名和文件名不一致（如
class Foo_Bar在foo_bar.php）→ classmap 是唯一选择，psr-4 根本不认这种命名 - 想临时加载本地未打包的 SDK 进行调试 → 别动主
autoload，改用autoload-dev或repositories+path类型引入
最容易被忽略的是：PSR-4 的路径拼接是纯字符串操作，不走文件系统查找。哪怕你把文件放对了位置，只要命名空间声明少了一个 \，或者路径多了一个 /，它就安静地失败，连 warning 都不报。
