codeigniter中vendor/autoload.php加载失败，90%因public/index.php中require路径写死或项目结构错位导致；需验证file_exists(fcpath . '../vendor/autoload.php')返回true，且composer.json的psr-4映射末尾带反斜杠、路径与命名空间严格对应。
CodeIgniter 项目中 vendor/autoload.php 加载失败，90% 是入口路径写死或结构错位导致的，不是 Composer 没装好，也不是框架坏了。
public/index.php 里的 require 路径是否真能命中 vendor/
CI4 默认在 public/index.php 第 14 行左右写死：require FCPATH . '../vendor/autoload.php';。这行代码看似合理，但极易因部署位置不同而失效。
- 如果项目放在
/var/www/html/myapp/，且用http://localhost/myapp访问，FCPATH指向/var/www/html/myapp/public/，那么../vendor/才是正确路径 - 如果误把整个项目（含
public/）放进/var/www/html/myapp/public/，FCPATH就变成/var/www/html/myapp/public/public/，../vendor就完全找偏了 - 用
file_exists(FCPATH . '../vendor/autoload.php')在index.php开头加一行临时调试，输出bool(true)才算过关 - 别硬改
../vendor为../../vendor或绝对路径 —— 这会破坏可移植性，应统一通过项目根目录结构来对齐
composer.json 的 autoload 配置是否匹配实际目录
CI4 官方推荐结构是 app/ 目录放应用代码，但很多人沿用 CI3 习惯把类放在 app/Controllers/ 却在 composer.json 里配成 "App": "src/"，结果自动加载永远找不到。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 运行
composer dump-autoload -v，看输出里有没有扫描到你的app/目录；如果没有，说明composer.json的autoload段根本没生效（常见于 JSON 格式错误、缩进不一致、漏逗号） - PSR-4 映射末尾必须带反斜杠：
"App\": "app/"✅，"App\": "app"❌（少一个会导致命名空间截断失败） - 确认类文件路径与命名空间严格对应：比如
app/Controllers/HomeController.php内必须声明namespace AppControllers;，不能是Appcontroller或appcontrollers - CI3 项目若手动接入 Composer，
composer.json必须放在项目根目录（和system/同级），不是application/下
vendor/autoload.php 存在但 Class not found 怎么办
文件存在 ≠ 自动加载生效。Composer 生成的映射文件（如 vendor/composer/autoload_psr4.php）可能被 OPcache 缓存，或者 classmap 和 psr-4 混用时逻辑覆盖出人意料。
- CLI 下跑通但 Web 请求报错？执行
php -r "opcache_reset();"只清 CLI 缓存；Apache/Nginx 需重启服务或调用对应 SAPI 的opcache_reset() - 删掉
vendor/composer/autoload_*.php全部文件，再跑composer dump-autoload -v，避免旧映射残留干扰 - 检查是否混用了
classmap和psr-4：如果一个类名同时被classmap显式注册和psr-4推导命中，classmap优先 —— 这可能导致你改了文件却还在走旧路径 - 用
composer show --path my/package确认你要用的类是否真在 autoload 映射表里；如果返回空，说明它压根没被收录
删了 vendor 怎么快速恢复 autoload
别急着 composer update，那会升级所有依赖，可能引入不兼容变更。只重建 autoload 映射，install 就够了。
- 保留
composer.lock和composer.json，直接运行composer install—— 它会重装 vendor 并刷新全部 autoload 文件 - 如果
composer.lock也丢了，先composer install --no-scripts避免 post-install 脚本执行失败中断流程，再补dump-autoload - CI/CD 流水线建议用
composer dump-autoload -o -a（即--optimize --classmap-authoritative），强制只走 classmap，能提前暴露漏扫的类文件 - 本地开发频繁改结构时，加
--no-scripts参数跳过post-autoload-dump，防止第三方脚本干扰排查
最常被忽略的是：Web SAPI 和 CLI 的 OPcache 彼此隔离，改完配置后只在命令行验证成功，不代表浏览器请求也 OK；还有 IDE 缓存符号表，关掉项目重开有时比改十行代码更管用。
