files 必须写相对于 composer.json 的路径且执行 composer dump-autoload 才生效，否则函数未加载；它全局一次性引入，不依赖命名空间，与 psr-4 本质不同。
composer.json 里 files 怎么写才生效
直接写进 autoload.files 数组，Composer 才会在每次 autoload.php 加载时无条件引入这些文件——不是“按需”，而是“必载”。它和 psr-4 不同，不依赖命名空间或类名匹配，只靠路径硬加载。
常见错误是把路径写成相对 vendor/ 或当前工作目录的路径，其实必须是相对于 composer.json 所在位置的路径：
-
"files": ["src/helpers.php"]✅（src/和composer.json同级） -
"files": ["./src/helpers.php"]❌（.会被忽略，等价于"src/helpers.php"，但加点反而误导） -
"files": ["vendor/my/package/src/functions.php"]❌（不能跨包引用，且 Composer 不会帮你 resolve 到实际路径）
为什么 helpers.php 里的函数还是报 Call to undefined function
根本原因只有两个：没执行 composer dump-autoload，或者文件里定义了函数但没被真正加载进来。Composer 不会监听文件变更自动重载，改完 composer.json 或新增 files 后必须手动刷新 autoload 映射。
- 运行
composer dump-autoload（或简写composer du）后，检查vendor/composer/autoload_files.php是否已把你的路径写进去 - 确保
helpers.php中没有语法错误，否则 Composer 加载时会静默失败（不会报错，但函数不可用） - 如果用了短数组语法
[]但项目 PHP 版本低于 5.4，也会导致加载中断
和 include_once 手动引入比，files 有什么实际影响
本质区别在于加载时机和作用域：files 是全局、一次性的，在 Composer 自动加载器初始化阶段就执行；而手写 include_once 是按需、分散的，容易漏、难维护，还可能重复包含。
- 性能上几乎无差别——都是单次 include，但
files更可控，避免某处忘记引入导致函数缺失 - 兼容性没问题，PHP 5.3+ 全支持，但注意：如果多个包都声明了
files，它们的加载顺序由 Composer 内部决定，不保证先后，别让函数互相依赖 - 调试时可以直接看
vendor/composer/autoload_files.php，一眼确认是否注册成功
能不能在 files 里加载带命名空间的文件
可以，但没必要，也不推荐。因为 files 的设计目的就是加载纯函数、常量、全局配置这类“无状态”的代码块。如果你的文件里有 namespace 声明，又没定义任何类，那它大概率本就不该走 files 路径。
- 写了
namespace Foo;但只定义函数？函数仍属于全局命名空间，namespace声明完全无效 - 想按命名空间自动加载？请用
psr-4或classmap，别硬塞进files - 真要加载含
namespace的辅助类？那它本质是类，应该放进psr-4并 new 实例，而不是靠files拉平作用域
最常被忽略的是：改完 composer.json 后不 dump-autoload，然后花半小时查函数为啥找不到——其实就差这一行命令。还有人把路径写成绝对路径或 URL，Composer 会直接跳过，连警告都没有。
