composer.json必须放在项目根目录，vendor/必须与之同级；composer只识别当前工作目录下的composer.json，不向上查找或支持嵌套，放错位置会导致install失败、类找不到等问题。
composer.json 必须放在项目根目录，vendor/ 必须与它同级 —— 这不是建议，是 Composer 的硬性规则。 任何试图把 composer.json 放进 src/、app/ 或子模块目录的做法，都会导致 composer install 失败或生成错误的 vendor/ 路径，后续所有自动加载、命令执行、CI 流水线都会出问题。
composer.json 放错位置的典型报错和修复
常见现象是运行 composer install 后提示：Could not find a composer.json file in /path/to/project/src，或者安装完类找不到、Class not found。这是因为 Composer 只认当前工作目录下的 composer.json，不会向上查找父目录，也不支持多 composer.json 嵌套管理。
- 修复方式只有一种：把
composer.json移回项目最外层目录（即 Git 仓库根） - 确认当前终端在该目录下再执行
composer install - 如果之前已在子目录执行过命令，先删掉子目录里残留的
vendor/和composer.lock
PSR-4 映射与文件路径必须三者对齐
自动加载失败的根源，90% 是 composer.json 里的 "psr-4" 配置、PHP 文件里的 namespace 声明、实际文件系统路径这三者没对上。比如：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 你写了
"App\": "src/"，那App\Http\Controllers\HomeController就必须落在src/Http/Controllers/HomeController.php - 如果类文件里写的是
namespace AppHttpControllers;（缺反斜杠），或路径是src/controllers/HomeController.php（小写、少层级），都会加载失败 -
src/下不能混放不同命名空间的类，例如把App\Services\和Vendor\Tool\都塞进同一个src/目录却不拆映射
vendor/ 和 composer.lock 的提交策略必须区分项目类型
这是最容易被团队搞混、引发部署不一致的关键点：
- 如果是应用（application）：必须提交
composer.lock，且vendor/必须出现在.gitignore中 —— CI 流水线靠composer install精确还原依赖 - 如果是库（library）：不能有
vendor/目录（本地也不该运行composer install），composer.lock不应提交，因为使用者才决定最终依赖版本 - CI 中漏检查
composer.lock是否存在或是否被.gitignore错误排除，会导致缓存命中旧 lock 或装出随机版本
autoload 优化不是加 -o 就万事大吉
composer dump-autoload -o 生成静态映射表确实快，但前提是你的 PSR-4 路径足够干净。如果 "App\": "src/" 指向的 src/ 里混着 config/、migrations/、fixtures/ 这类非类文件，autoloader 仍会扫描整个目录树，-o 几乎没用。
- 更有效的做法是拆分 autoload：核心逻辑走
psr-4，工具函数、单文件类走classmap - 开发时可在
composer.json的config节加"optimize-autoloader": true，上线再用--optimize-autoloader参数触发 - 慎用
-a（--classmap-authoritative）：它会让 autoloader 完全跳过文件系统查找，只查 classmap —— 一旦漏收某个类，直接Class not found，连提示都没有
真正难的不是写对一行 "psr-4"，而是让命名空间、目录结构、文件名大小写、Git 提交习惯全部咬合在一起。稍有松动，就会在某次 composer update 或新成员拉代码后突然崩掉 —— 而这种问题往往没有明显报错，只有类找不到。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
