autoload.files没生效需检查三处：路径是否为composer.json所在目录的相对路径、是否执行composer dump-autoload刷新、文件内是否含未加载类的调用或重复函数定义。
autoload.files 为什么没生效？检查这三处
Composer 的 autoload.files 看似简单，但实际常因路径、时机或加载顺序问题完全静默失败——它不会报错，只是函数压根没被定义。
常见错误现象：Call to undefined function my_helper()，而你确信已写进 autoload.files；或者本地运行正常，部署后函数找不到。
- 路径必须是相对于
composer.json所在目录的**相对路径**（不是相对于当前工作目录，也不是相对于 vendor） - 文件必须在
composer install或composer dump-autoload后才真正写入vendor/autoload.php的加载逻辑中 - 若该文件依赖其他类或函数（比如用了
Illuminate\Support\Str），它会在 autoloader 初始化前执行——此时类尚未加载，会 fatal error
怎么写 autoload.files 才安全？用绝对路径 + 延迟加载
直接在 composer.json 里写相对路径风险高，尤其跨环境时。更稳妥的做法是：把全局函数封装进一个“引导文件”，并在其中做存在性判断和延迟加载。
使用场景：定义少量工具函数（如 str_slug()、dd() 替代品）、配置辅助函数，不涉及复杂依赖。
- 在项目根目录建
src/Support/functions.php，只放纯函数，不require其他文件 -
composer.json中写："autoload": { "files": [ "src/Support/functions.php" ] } - 运行
composer dump-autoload（不是install）才能刷新 autoload_files 列表
autoload.files 和 psr-4 混用时谁先加载？别依赖顺序
Composer 不保证 autoload.files 和 psr-4 类的加载顺序——它们被合并进同一个 vendor/autoload.php，但函数文件在 autoloader 注册前就 require_once 进来了，而类是按需加载的。
性能影响：所有 autoload.files 里的文件在每次请求入口（如 index.php）中 require 'vendor/autoload.php' 时就会无条件执行一次，无法懒加载。
- 不要在
functions.php里调用new SomeClass()—— 类可能还没加载 - 避免在其中做耗时操作（如读配置文件、连数据库），它会在每个 CLI 命令和 Web 请求里都执行
- 如果函数需要类支持，改用
class_exists()包裹，或改用服务提供者（Laravel）/扩展机制（非框架项目）
全局函数被覆盖或冲突？看 vendor/autoload.php 生成结果
Composer 最终把 autoload.files 编译进 vendor/autoload.php，你可以直接打开它确认是否写入成功——搜索 files = array( 或类似结构。
容易踩的坑：多个包都声明了 autoload.files（比如你引入的某个 SDK 也这么干），它们会全部被加载，且顺序由 Composer 内部决定，函数重复定义会 fatal。
- 用
function_exists()包裹你的函数定义，例如：if (!function_exists('my_log')) { function my_log($msg) { ... } } - 不要在
autoload.files中使用include或require动态加载其他 PHP 文件——Composer 不会追踪这些间接依赖 - CI/CD 部署时记得
composer install --no-dev可能跳过某些 dev-only 的 autoload.files（取决于包是否标记为require-dev）
最麻烦的点其实不在配置本身，而在函数文件一旦被加载，就脱离了命名空间和作用域控制——它真正在全局生效，且没有“卸载”机制。改名、重构、测试隔离都会比类更难收场。
