根本原因是composer的files加载机制未触发或路径/时机/环境不匹配：大小写敏感导致路径失效、未加function_exists()防重定义、vendor/autoload.php未在所有入口引入、autoload_files.php路径错误或文件语法错误。
全局辅助函数能挂上，但用着总报 Call to undefined function？根本原因不是函数没写，而是 Composer 的 files 加载机制没被真正触发，或路径/时机/环境三者中至少一个没对齐。
composer.json 里 files 路径必须严格匹配文件系统大小写
Linux/macOS/Docker 容器中，app/helpers/helpers.php 和 app/Helpers/helpers.php 是两个不同路径。Composer 不会自动纠错，它只按字面路径去 require_once——路径错，就静默跳过，不报错也不警告。
- 用
ls -l app/Helpers/确认真实目录名大小写，再照抄进composer.json - Windows 下开发完推到 Linux 服务器，务必检查 Git 是否保留了大小写（
git config core.ignorecase false可临时规避） - 路径里不要用
./或../前缀，一律从项目根目录开始写，比如"app/Helpers/helpers.php"，不是"./app/Helpers/helpers.php"
函数定义前必须加 function_exists() 防重声明
Laravel 自带的 helpers.php、PHP 8.0+ 内置函数（如 str_contains()、str_starts_with()）、甚至某些扩展（如 mb_ 系列）都可能和你自定义的函数同名。一旦重复，运行时直接 Fatal error: Cannot redeclare，且错误堆栈指向 ClassLoader.php，误导性极强。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 每个函数都要包一层判断：
if (!function_exists('my_format_date')) { function my_format_date($dt) { ... } } - 别依赖“我写的函数名肯定没人用”——第三方包、升级后的 PHP 版本、甚至 Laravel 新版本都可能悄悄塞进同名函数
- 不推荐在
files文件里require其他文件，子文件加载顺序不可控，容易引发隐式重定义
Web 请求 vs CLI 下函数不可用，本质是 vendor/autoload.php 没被入口文件引入
Composer 的 files 不是“注册即生效”，它只是把路径记进 vendor/composer/autoload_files.php；最终靠 require_once 'vendor/autoload.php' 这一行代码来批量 include 所有 files 列表里的文件。Laravel 的 public/index.php 有这行，但你自己写的 CLI 脚本、测试启动文件、或 Nginx/Apache 配置直连的 PHP 文件，很可能漏了。
- 检查 Web 入口：确认
public/index.php包含require __DIR__.'/../vendor/autoload.php'; - 检查 CLI 脚本：自己写的
artisan命令或独立脚本，开头必须手动requireautoload - PHPUnit 测试：在
phpunit.xml的<php><server name="autoload" value="vendor/autoload.php"></server></php>或bootstrap属性中显式指定
执行 composer dump-autoload 后仍不生效？先看 vendor/composer/autoload_files.php
这个文件是 dump-autoload 的产物，也是运行时实际加载的依据。它里面是一段 PHP 数组，每一项都是硬编码的绝对路径。如果部署时用了 rsync、Docker COPY、或 CI/CD 清除了 vendor 但没重装，这个文件里的路径就可能指向已不存在的位置，或软链接被展开后失效。
- 打开
vendor/composer/autoload_files.php，确认数组里出现的是你刚配置的路径，且路径拼出来确实存在（用ls -l验证） - 如果路径含
/var/www/html/...之类本地开发路径，说明生成时工作目录不对，删掉vendor/composer/整个目录，再跑一次composer install - 函数文件本身不能有语法错误——哪怕一个多余逗号，也会让整个 autoloader 中断，连
App\Http\Controllers\Controller都找不到
最常被忽略的一点：函数文件被加载的时机早于 Laravel 容器初始化。这意味着你在 helpers.php 里直接调用 app()、config() 或任何依赖服务容器的逻辑，一定会失败。纯函数、无副作用、不依赖框架上下文——这才是 files 的安全边界。
