PHP 不支持函数按需加载，因内核不拦截函数调用；autoload.files 是唯一机制，仅通过 require_once 无条件预加载指定文件，路径须相对 composer.json、修改后须手动执行 composer dump-autoload，且文件严禁含副作用代码。
不支持。PHP 本身没有函数按需加载机制，Composer 的 autoload.files 只能无条件加载整个文件，调用前必须已存在所有函数。
为什么不能“按需加载函数”
PHP 内核只对未定义类触发 autoload 回调，但对函数调用不做任何拦截——my_helper() 执行时若函数未声明，直接报 Fatal error: Uncaught Error: Call to undefined function，不会走 Composer 或任何自动加载流程。
- PSR-4、classmap 都只处理
class、interface、trait，完全忽略文件里的函数 -
autoload.files是唯一入口，但它在require vendor/autoload.php时就require_once所有列出的文件，不是“调用时才加载” - 试图在 PSR-4 类文件里混写全局函数？Composer 不保证该文件被加载，函数依然不可用
autoload.files 配置必须注意的三件事
它看似简单，但路径错、没 dump、有副作用，三者任一都会导致函数“明明写了却找不到”，且不报错。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 路径必须相对于
composer.json所在目录，写"src/helpers.php"，不能写"./src/helpers.php"或"/full/path/src/helpers.php" - 改完
composer.json后必须手动运行composer dump-autoload，否则vendor/composer/autoload_files.php不更新，函数永远不生效 - 文件里禁止运行时副作用：不能
echo、不能file_get_contents、不能new实例——这些代码会在 CLI 命令、测试启动、甚至phpunit --version时就被执行
多个函数文件怎么安排顺序
files 数组顺序 = 实际 require_once 执行顺序，直接影响常量和函数可用性。
- 先加载
"config/constants.php"（定义define('APP_ENV', 'dev')），再加载"src/Helpers/functions.php"（里面用到了APP_ENV） - 反过来就会报
Use of undefined constant APP_ENV，甚至因逻辑错误导致后续函数注册失败 - 同名函数会被后加载的覆盖，如两个文件都定义
str_slug()，后者生效；没加function_exists()防护会直接Fatal error
测试里函数报错的真正原因
不是 Composer 配错了，而是测试环境没正确引入自动加载器。
- PHPUnit 默认只 require
vendor/autoload.php，但如果你的files配置没生效（漏了dump-autoload），函数就不存在 - 检查
phpunit.xml的bootstrap是否指向vendor/autoload.php；不要在测试文件里手动require 'src/helpers.php'，这绕过自动加载且易重复定义 - 并行测试工具（如 ParaTest）可能隔离 autoloader，需确认其是否复用同一份
autoload_files.php
真正麻烦的不是配置，而是误以为“函数可以像类一样懒加载”。一旦把初始化逻辑、I/O 操作塞进 files 文件，问题会在最意想不到的时机爆发——比如在生成 API 文档或运行静态分析时突然连接数据库失败。
