autoload.files 必须写相对于 composer.json 的真实 PHP 文件路径，如 "src/helpers.php"；多个文件按加载顺序排列；修改后需运行 composer dump-autoload 生效，否则函数更新不生效。
composer.json 里 autoload.files 怎么写才生效
必须把自定义函数文件路径写进 autoload.files 数组，且路径是相对于 composer.json 所在目录的。Composer 不会递归扫描、也不会自动识别 functions.php 这类命名惯例。
- 路径必须是真实存在的 PHP 文件（不能是目录或不存在的文件），否则
composer dump-autoload不报错，但运行时会提示Warning: require(...): failed to open stream - 推荐用相对路径，比如
"src/helpers.php"；避免用__DIR__或绝对路径——autoload.files只接受字符串字面量 - 多个文件就写多个字符串，顺序即加载顺序：靠前的文件里定义的函数，后面文件才能覆盖或复用
函数文件被加载了但调用时报 Fatal error: Call to undefined function
常见原因是文件里定义了函数，但没加 if (!function_exists('xxx')) 防重载，而该文件又被多次 require（比如在测试环境手动 require 了一次，又依赖 autoload 加载一次）。
- 检查是否在
phpunit或调试脚本中手动require过同名文件——autoload 机制和手动 require 混用极易触发重复定义 - 函数名冲突时，PHP 报错是
Fatal error，不是Warning，说明解析阶段就卡住了，和 autoloader 是否启用无关 - 如果函数只是工具性质（如
str_slug()），建议统一收口到一个类的静态方法里，比纯函数更可控
为什么改了 helpers.php 里的函数，Web 请求里却没更新
因为 Composer 的 autoload_files.php 是生成的静态映射文件，默认不随源文件变化实时刷新。你改了函数体，但 vendor/autoload.php 仍引用旧版本。
- 每次修改
autoload.files列表里的文件内容后，必须执行composer dump-autoload（或简写composer du） - 开发中可加
--optimize-autoloader（即-o），它会把files类型也合并进优化后的autoload_static.php，但不会跳过重新生成步骤 - 某些 IDE 或 Swoole 热重载环境会缓存 opcode，即使 autoload 更新了，也可能要重启 Web 服务或 CLI 进程
autoload.files 和 psr-4 混用时要注意什么
autoload.files 是无条件提前加载的，不管有没有 new 实例或调用函数；而 psr-4 是按需加载。两者共存时，加载时机差异可能引发依赖顺序问题。
- 如果
helpers.php里用了某个 PSR-4 类（比如App\Support\Str），但该类还没被 autoload 加载，就会报Class 'App\Support\Str' not found - 解决方案只有两个：要么把依赖类也放进
autoload.files（不推荐，破坏封装），要么把函数逻辑移到类方法里，通过依赖注入或静态调用解耦 - 别指望
autoload.files能“初始化”某些全局状态——它只负责加载，不保证执行顺序，尤其在多进程/多线程环境下不可靠
最常被忽略的一点：autoload.files 加载的是 PHP 文件，不是配置或 JSON；里面不能有语法错误，哪怕只是多了一个逗号，composer dump-autoload 也会静默失败（实际没生成新文件），但后续请求直接崩。
