classmap路径必须相对于composer.json、不加./、末尾无斜杠、用数组列出目录；files仅初始化时加载且不支持命名空间；psr-4与classmap混用同一目录会导致冲突；class not found主因是opcache未清或autoload.php未加载。
classmap 映射老项目类文件时路径怎么写才有效
必须用相对于 composer.json 的路径，不加 ./ 前缀；路径末尾不带斜杠；多个目录用数组列出，不能用通配符或 glob 表达式。
-
"classmap": ["models", "lib", "includes"]✅ 正确，Composer 会递归扫描这些目录下所有.php文件并生成静态映射 -
"classmap": ["./models/"]❌./被忽略，/末尾被截断，实际等价于["models"]，但写法冗余且易误导 -
"classmap": ["models/*.php"]❌ 不支持 shell glob，直接报错或静默跳过 - 若老类在子目录（如
models/user/User_model.php），只要models/在 classmap 列表里，就一定能扫到——不用管文件名是否含下划线、是否匹配类名
全局函数和常量文件为什么加了 files 还是找不到
因为 files 是“加载即执行”，不是“按需加载”；它只在 vendor/autoload.php 初始化时一次性包含，且顺序固定在 PSR-4/classmap 之前。常见失效原因是：函数定义被重复包含，或依赖未初始化。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 确保每个
files条目是完整可执行的 PHP 文件，不含class或namespace声明（否则会被 classmap 误扫） - 不要把
config.php放进files—— 它通常含define()和global $db，提前执行会导致后续逻辑出错 - 如果函数依赖某个已加载的类（比如
helper_log()内部 new Db()），而Db类又没被 classmap 覆盖，就会 fatal —— 此时应优先补全 classmap，而非硬塞进 files - 运行
composer dump-autoload后，检查vendor/composer/autoload_files.php是否已写入对应路径，这是验证是否生效的最直接方式
PSR-4 和 classmap 混用同一目录会出什么问题
会加载失败或覆盖失效：PSR-4 按命名空间+文件名规则查找，classmap 按扫描结果硬映射；两者冲突时，Composer 默认以 PSR-4 为准，但 classmap 扫描结果可能漏掉部分文件，导致 “Class not found”。
- 绝对不要写：
"psr-4": {"App\": "src/"}, "classmap": ["src/"]—— src/ 下带命名空间的类走 PSR-4，无命名空间的老类却因 PSR-4 规则被跳过，classmap 又因目录已被 PSR-4 占用而不扫描 - 正确做法：老代码统一走
classmap，新代码走psr-4，目录物理隔离（如"psr-4": {"App\": "app/"}+"classmap": ["legacy/"]） - 若实在无法拆目录，可用
classmap单独列具体文件："classmap": ["src/User_model.php", "src/Helper.php"]，绕过目录级冲突
为什么 dump-autoload 后还是 Class not found
大概率是 opcache 没清，或者入口文件没真正加载 vendor/autoload.php —— Composer 生成的映射表生效前提是：自动加载器已注册，且类名与映射完全一致（大小写敏感、无多余空格）。
- 执行
composer dump-autoload -o后，务必清理 opcache：opcache_reset()或重启 PHP-FPM；否则旧映射仍在内存中 - 确认入口文件（如
index.php）第一行就是require_once __DIR__ . '/vendor/autoload.php';，且没有被条件语句包裹 - 检查类名拼写：老代码里
class user_model和new user_model()是合法的，但 Composer classmap 只认class user_model的声明，调用时也必须小写 —— 如果代码里写成new User_Model()就会失败 - 别信 IDE 的“跳转到定义”：它可能缓存了旧路径，真实加载行为以
get_declared_classes()输出为准
