files数组加载纯PHP函数文件，路径须相对于composer.json且不能跨出项目根；需执行composer dump-autoload生效，是Composer唯一官方支持的函数自动加载方式。
files数组到底加载什么文件
它只负责在 Composer 自动加载机制启动时，无条件引入指定的 PHP 文件——不是类，不是命名空间，就是纯函数文件。这些文件会在每次 autoload.php 被 require 时执行一遍，相当于全局 include。
常见错误现象：Call to undefined function my_helper()，明明写了 files 却不生效，大概率是路径写错、没运行 composer dump-autoload，或文件里没定义函数（比如只写了注释或 class）。
- 路径必须相对于
composer.json所在目录，不能用../跨出项目根（Composer 会拒绝） - 推荐放在
src/或functions/下，例如"files": ["src/helpers.php"] - 文件内不能有语法错误，否则整个 autoload 会中断，连类都加载不了
为什么不用 autoload.files 而用 files
files 是 composer.json 的顶层字段，属于“自动加载配置”的一部分；而 autoload.files 是无效写法——根本不存在这个键。正确写法只有 "autoload": { "files": [...] }。
使用场景：当你有一批工具函数（如 str_slug()、array_dot()），又不想包进类里、也不打算走 PSR-4，就靠 files 最直接。
- PSR-4 无法加载函数，只能加载类；
files是唯一官方支持的函数加载方式 - 如果同时用了 PSR-4 和
files，两者互不影响，但files总是先执行 - 注意：Laravel 的
helpers.php就是这么加载的，但它是通过框架自己 require 的，不是靠 Composerfiles
运行后不生效？检查这三个点
改完 composer.json 不等于立刻生效，Composer 不会监听文件变化自动重载。
- 必须手动执行
composer dump-autoload（开发时可加-o生成优化后映射） - 确认
vendor/autoload.php确实被项目入口引入了（比如index.php里有没有require 'vendor/autoload.php'） - 检查文件权限和路径大小写——Linux 下
Helpers.php和helpers.php是两个文件
一个小验证技巧：在你要加载的 PHP 文件开头加一行 echo "loaded\n";，然后跑一次脚本，看是否输出——能输出就说明路径和加载流程没问题。
性能与兼容性要注意什么
files 里的每个文件都会在每次请求时无条件执行，哪怕你只用了一个函数。它没有懒加载，也没有条件判断。
- 别把大段逻辑、数据库连接、HTTP 请求塞进去，这会拖慢所有请求
- PHP 5.6+ 都支持，但低于 5.6 的环境（比如某些旧 Docker 镜像）可能因语法报错导致 autoload 失败
- 多个包都用
files时，加载顺序按composer.json中声明顺序，但不同包之间顺序不可控（Composer 未保证）
真正容易被忽略的是：一旦函数名冲突（比如两个包都定义了 dd()），后加载的会覆盖先加载的，且没有任何警告。这种问题在线上才暴露，调试起来非常隐蔽。
