composer 的 files 配置必须置于 autoload 顶层，执行 composer dump-autoload 后生效；路径为相对路径，按数组顺序加载，不支持通配符，修改后须手动刷新自动加载文件。
Composer 可以通过 files 配置项自动加载全局函数文件，但必须放在 autoload 的顶层（不是 autoload-dev），且仅在执行 composer dump-autoload 后生效。
files 配置必须写在 composer.json 的 autoload 字段下
很多人误把 files 放进 autoload-dev，结果函数始终不加载——autoload-dev.files 不会被自动引入到生产环境的 autoloader 中，即使你本地运行了 composer install --no-dev 也不会加载它。
正确位置是：
{
"autoload": {
"files": [
"src/Helpers/functions.php",
"src/Constants.php"
]
}
}
注意：files 数组里的路径是相对于 composer.json 所在目录的相对路径，不能用 ../ 跨出项目根目录，否则 dump-autoload 会报错或静默忽略。
加载顺序不可控，避免函数重复定义
Composer 按数组顺序依次 require 这些文件，但如果你的多个 files 之间有依赖（比如 A.php 里调用了 B.php 定义的函数），就必须手动保证顺序；一旦顺序错乱，运行时直接报 Fatal error: Call to undefined function。
- 不要在
files列表里重复包含同一文件（即使路径不同） - 避免在
files中使用function_exists()包裹函数定义——这会让 IDE 和静态分析工具失效，也掩盖了实际冲突 - 如果函数逻辑复杂或需依赖类，优先考虑封装为类的静态方法，而非全局函数
修改 files 后必须重新生成 autoload 文件
composer install 或 composer update 不会自动触发 files 加载逻辑的更新；只有 composer dump-autoload（或带 --optimize 参数的变体）才会重写 vendor/autoload.php 并注入 files 的 require 语句。
常见表现：
- 改完
composer.json里的files，函数还是找不到 → 忘了运行composer dump-autoload - 删掉某个
files条目后函数还能调用 → 旧的vendor/autoload.php缓存未刷新
可加 -v 查看是否真的加载了：
composer dump-autoload -v # 输出中应包含类似： # Generated autoload files for files: src/Helpers/functions.php, src/Constants.php
files 不支持通配符或动态路径
Composer 的 files 是静态列表，不支持 *、** 或 glob()。想自动加载整个 helpers/ 目录下的所有 .php 文件？不行。必须显式列出每个文件。
替代方案有限：
- 写脚本自动生成
files数组并更新composer.json（不推荐，破坏可读性） - 在入口文件（如
index.php）里手动require一次目录遍历（绕过 Composer，但失去统一管理） - 改用
psr-4+ 工具类：把函数包装成Helper::doSomething()，更易测试和维护
真正需要大量全局函数的项目，往往说明职责边界已模糊——files 是临时补丁，不是架构方案。
