最常见原因是入口文件未引入或错误引入vendor/autoload.php；files路径须相对于composer.json、需执行composer dump-autoload、文件必须含.php扩展且仅含函数/const定义。
为什么加了 files 还是报 Call to undefined function
最常见原因是入口文件根本没引入 vendor/autoload.php，或者引入位置错了。Composer 的 files 列表只在 vendor/autoload.php 被 require 时才执行，它不依赖自动加载机制，而是无条件 require_once。如果项目里漏掉这行、写在其他 require 之后、或路径写错（比如用相对路径 ../vendor/autoload.php），函数就永远不会被加载。
必须确保：
- 入口文件（如 index.php 或 cli.php）第一行或至少在调用任何自定义函数前，有 require __DIR__ . '/vendor/autoload.php';
- composer.json 所在目录下已成功运行过 composer dump-autoload
- files 中的路径是相对于 composer.json 的，不是相对于入口文件或 vendor/
files 字段的路径怎么写才不会错
files 里的路径必须是“从 composer.json 所在目录出发”的相对路径，且不能省略扩展名。写成 "helpers.php" 是错的——它会被解释为当前目录下的 helpers.php，而你实际可能放在 src/helpers.php。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
正确写法示例：
- "src/helpers.php"
- "config/constants.php"
- "legacy/functions_legacy.php"
错误写法示例：
- "helpers.php"（路径不明确，易错）
- "/src/helpers.php"（开头斜杠变成绝对路径，Composer 会忽略）
- "src/helpers"（缺 .php，不会被加载）
多个 files 的加载顺序和潜在冲突
files 列表中的文件按数组顺序被 require_once，但这个顺序不可控地受 Composer 内部合并逻辑影响——尤其是当多个包（包括 require 的第三方包）都声明了 files 时，最终加载顺序由 Composer 解析依赖图后决定，不是简单按你写的顺序来。
容易踩的坑：
- A.php 定义函数 foo()，B.php 依赖 foo()，但 B 在 files 数组里排前面 → 运行时报 Call to undefined function foo
- 同一个函数在两个 files 里被重复定义 → Cannot redeclare foo()
- files 里写了类定义（比如 class Helper {}）→ 后续 PSR-4 加载同名类时会因重复定义报错
建议：只把纯函数、define()、const 放进 files；有依赖关系的，合并到单个文件，或改用 classmap 封装成类。
改了 files 为什么 dump-autoload 没反应
composer dump-autoload 不会报错，也不提示“已更新 files”，但它确实生效了——因为 files 的加载逻辑写死在生成的 vendor/autoload.php 里，每次运行该命令都会重写这个入口文件。如果你改完没看到效果，大概率是：
- 没在 composer.json 所在目录执行命令（比如误入 src/ 下运行）
- 忘记清除 OPCache（PHP 8+ 默认开启，opcache_reset() 或重启 PHP-FPM）
- 用了某些 Composer 插件（如 hirak/prestissimo）缓存了 autoload 行为，可加 --no-plugins 重试
- 文件本身语法错误（比如 helpers.php 里有 parse error），会导致 require_once 失败但不中断整个 autoload 流程，函数自然不可用
