autoload.php 是唯一标准启动点，需确保正确 require 且路径准确；Class not found 或 Cannot redeclare class 多因路径错误、重复加载或未配置 autoload 字段。

composer autoload.php 不生效，怎么手动加载 vendor 目录

vendor 目录本身不提供“手动加载”入口，autoload.php 是唯一标准启动点；所谓“手动加载”，本质是确保 require 到了它，且路径正确。

常见错误现象：Class not found 即使类文件明明在 vendor/ 里；或脚本运行时提示 Cannot redeclare class —— 往往是重复 require 或加载顺序错乱。

• 确认 vendor/autoload.php 存在：运行 composer install 或 composer dump-autoload 后才生成，空目录或未执行安装则该文件不存在
• 路径必须相对当前执行脚本有效：比如脚本在 public/index.php，就得写 require __DIR__.'/../vendor/autoload.php';，不能硬写 require 'vendor/autoload.php';
• 不要用 include 替代 require：失败时不报错，后续类找不到更难排查

require_once vendor/autoload.php 报错 “No such file or directory”

这不是 composer 的 bug，而是当前工作目录或路径计算出错。PHP 不会自动识别项目根目录，vendor/ 永远相对于 composer.json 所在位置，而非 PHP 脚本所在位置。

使用场景：命令行跑测试脚本、crontab 调度、或 Web 入口不在项目根目录（如 Nginx 配置指向 public/）。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 优先用 __DIR__ 向上追溯：例如 require __DIR__.'/../vendor/autoload.php';（适用于 public/ 下的入口）
• 避免依赖 getcwd()：CLI 下工作目录可能任意，require 'vendor/autoload.php' 极易失效
• 如果真不确定路径，加个判断：if (!file_exists(__DIR__.'/../vendor/autoload.php')) { die('vendor/autoload.php not found'); }

不走 composer autoload，想直接 require 单个 vendor 类文件

可以，但违背设计初衷，且极易出问题——多数包依赖 autoloader 处理命名空间映射、PSR-4 自动查找、甚至 files 类型的全局函数注册。

性能影响不大，兼容性风险高：比如 monolog/monolog 的 MonologLogger 类若手动 require 对应文件，其依赖的 MonologHandlerStreamHandler 等仍需 autoloader 加载，否则报错。

• 仅限调试临时绕过：比如快速验证某个第三方工具类是否存在，可 require 'vendor/some/package/src/Helper.php';
• 永远别在生产代码里写 require 'vendor/...'：路径硬编码、版本升级后文件结构变、Composer 插件（如 hirak/prestissimo）可能改变缓存行为
• 若真要脱离 autoloader，改用 classmap 生成静态映射：composer dump-autoload --classmap-authoritative，再确保 autoload.php 被引入

vendor/autoload.php 里为什么没加载我写的 src/ 类

因为 autoload.php 只加载 composer.json 中 autoload 字段声明的部分，它不是魔法扫描器。你写的 src/ 类默认不会被包含，除非显式配置。

典型错误：运行 composer install 后发现自己的类还是 Class not found，但第三方包正常。

• 检查 composer.json 是否有 "autoload": { "psr-4": { "App\": "src/" } } 这类声明
• 修改后必须运行 composer dump-autoload（开发中）或 composer install（CI/CD），否则变更不生效
• 注意命名空间与目录结构严格对应：类 AppHttpControllerHome 必须放在 src/Http/Controller/Home.php

实际最常卡住的地方，是以为 vendor/autoload.php 会“自动感知”所有代码，而忘了它完全由 composer.json 的 autoload 配置驱动——配置没写，它就真不知道。