autoload.files 是唯一靠谱的方式，因为 composer 不支持按命名空间自动加载普通函数文件，必须在 composer.json 中显式声明 files 数组，路径须为 unix 风格、文件必须存在且按执行顺序加载，修改后需运行 composer dump-autoload 生效。
为什么 autoload.files 是唯一靠谱的方式
Composer 不支持像类那样通过命名空间自动发现并加载普通函数文件，必须显式声明。你写的 helper.php 或 functions.php 不会因为放在 src/ 里就被自动载入——它压根不走 PSR-4 规则。唯一可靠的方法，是在 composer.json 中用 autoload.files 字段列出所有需全局加载的 PHP 文件路径。
怎么在 composer.json 里正确配置 autoload.files
这个字段接受一个字符串数组，每个元素是相对于项目根目录的 PHP 文件路径（必须是真实存在的文件，不能是 glob 模式或目录）。
- 路径写法必须是 Unix 风格，即使在 Windows 上也用
/，比如src/functions.php，别写src\functions.php - 文件必须已存在，
composer install或composer dump-autoload时会校验，缺失会报错：Warning: require(...): failed to open stream - 多个文件按执行顺序排列，前面的函数会被后面的同名函数覆盖（PHP 函数不能重定义，所以顺序很重要）
- 修改后必须运行
composer dump-autoload才生效，install或update也会触发
示例片段：
"autoload": {
"files": [
"src/helpers.php",
"src/constants.php"
]
}
函数文件里不能有语法错误，也不能依赖未加载的类
autoload.files 是在 Composer 自动加载器初始化早期就 require 的，此时 PSR-4 类还没注册，任何对未加载类的引用、静态调用或 new 实例化都会 fatal error。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 避免在
helpers.php里直接写App\Services\Logger::log()—— 改成函数内延迟调用，或改用闭包包装 - 不要在文件顶层做运行时逻辑，比如
file_get_contents(__DIR__ . '/config.json')，除非你确认路径一定存在且可读 - 函数名必须全局唯一；如果两个
autoload.files里都定义了str_slug()，第二个会报Cannot redeclare str_slug()
调试时怎么确认函数文件真的被加载了
最直接的办法不是猜，而是看生成的自动加载文件。运行 composer dump-autoload 后，打开 vendor/autoload.php，往下滑，找到类似这段：
require_once __DIR__ . '/../src/helpers.php'; require_once __DIR__ . '/../src/constants.php';
如果没看到，说明配置路径写错了、文件不存在，或者忘记执行 dump-autoload。也可以临时在函数文件开头加 echo "helpers loaded\n"; die; 来验证是否被执行——但上线前务必删掉。
注意：函数文件里的 return、exit 或未捕获异常，会让整个自动加载流程中断，后续所有类都无法加载，错误可能看起来像“Class not found”，其实根源在你的 helpers.php 里。
