在 composer.json 的 "autoload" 字段下配置 "files" 数组，填入相对于 composer.json 的 PHP 文件路径，执行 composer dump-autoload 后自动 require_once；需确保路径存在、无重复函数定义、测试中正确引入 vendor/autoload.php，且 files 与 psr-4 可共存。
composer.json 里怎么配 files 自动加载
直接在 composer.json 的 "autoload" 字段下加 "files" 数组，填入相对路径（相对于 composer.json 所在目录）。Composer 安装或更新时会把它们写进自动加载列表，运行时自动 require_once。
常见错误是路径写成绝对路径、用了 ./ 开头（不需要）、或路径不存在导致 composer dump-autoload 报错：
{
"autoload": {
"files": [
"src/helpers.php",
"app/functions/global.php"
]
}
}
- 路径必须存在，且是 PHP 文件（不能是 .txt 或未定义的扩展名）
- 不支持通配符（如
"src/*.php"），每个文件要单独列出来 - 修改后必须执行
composer dump-autoload，否则新文件不会生效 - 如果文件里有函数重定义（比如两次声明
my_helper()），运行时直接报Fatal error: Cannot redeclare
为什么 files 加载的函数在测试里找不到
PHPUnit 或其他测试框架默认只加载 Composer 自动生成的 vendor/autoload.php，但如果你在 files 里引入了辅助函数，而测试启动前没触发自动加载（比如没 require vendor/autoload.php），函数就不可用。
典型表现是：Call to undefined function my_helper()，哪怕 composer dump-autoload 成功了也一样。
- 确保测试入口（如
phpunit.xml的bootstrap配置）指向了vendor/autoload.php - 不要在测试文件里手动
require 'src/helpers.php'—— 这会绕过 Composer 自动加载逻辑，还可能引发重复定义 - 如果用了并行测试工具（如 ParaTest），确认它没有隔离 autoloader 环境
files 和 psr-4 能不能共存
可以，而且很常见：用 psr-4 加载类，用 files 加载全局函数。Composer 会合并处理，顺序上 files 总是在 psr-4 之前被载入。
但要注意冲突点：
- 如果
files里的文件又去require了某个类，而该类尚未由psr-4加载器注册，就会报Class not found -
files中的函数如果依赖某个尚未初始化的类（比如 Laravel 的app()），运行时会出错 —— 因为函数加载早于框架启动 - 多个
files之间有依赖顺序时，数组顺序就是载入顺序，别把被依赖的文件写在后面
加载失败时怎么快速定位问题
最直接的方法是检查生成的 vendor/composer/autoload_files.php 文件 —— 这是 composer dump-autoload 后实际生成的映射表。如果里面没出现你写的路径，说明配置没被识别；如果路径存在但运行时报错，则大概率是文件语法错误或函数重复定义。
- 运行
composer dump-autoload -v查看详细输出，会提示跳过哪些文件及原因 - 用
php -l src/helpers.php检查 PHP 语法是否合法 - 临时在
helpers.php开头加echo "loaded\n"; die;，看是否真被加载 - 注意 Windows 下路径分隔符不影响，Composer 内部已 normalize，但大小写敏感性仍需留意（尤其部署到 Linux）
files 是最轻量的函数加载方式，但也是最容易因路径、顺序、环境差异出问题的一环。只要路径写对、dump 做全、不和框架生命周期硬碰硬，基本不会掉链子。 
