autoload.files 是唯一靠谱方案，因为 php 函数无命名空间，psr-4/psr-0 无法自动发现，必须在 composer.json 中显式声明 files 数组路径，经 dump-autoload 写入 autoload.php 后才可调用。
Composer 不会自动加载 PHP 函数文件，必须显式声明为 files 类型的自动加载项，否则函数定义根本不会被引入。
为什么 autoload.files 是唯一靠谱方案
PHP 的函数（非类）没有命名空间绑定机制，无法靠 PSR-4 或 PSR-0 自动发现。Composer 唯一支持函数文件加载的方式，就是在 composer.json 里用 autoload.files 字段列出绝对路径（相对于项目根目录）的 PHP 文件。这些文件会在每次 composer dump-autoload 后写入生成的 vendor/autoload.php 中，并在 require 'vendor/autoload.php' 时立即执行——也就是函数被定义的时刻。
- 不写进
autoload.files，哪怕文件放在src/下、路径再规范，函数也永远不可用 -
psr-4或classmap对纯函数文件完全无效，别试 - 文件内不能有语法错误，否则整个 autoload 会中断，报错类似
PHP Fatal error: Uncaught Error: Call to undefined function xxx()
怎么写 composer.json 才能生效
直接在 autoload 段落下加 files 数组，每个元素是字符串路径，支持通配符 *（但不推荐，易出错）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"autoload": {
"files": [
"src/helpers.php",
"src/functions/strings.php"
]
}
}
- 路径必须是相对项目根目录的，不能以
./开头，也不能是绝对路径 - 文件必须存在且可读，
composer install或composer dump-autoload时会校验并报错 - 修改后务必运行
composer dump-autoload（或composer install/update），否则变更不生效 - 如果函数名冲突（比如两个文件都定义了
str_slug()），后加载的会覆盖前一个，但无警告
常见错误：函数明明写了却报 “undefined function”
这不是 Composer 的锅，而是加载链断在了某个环节：
- 忘了运行
composer dump-autoload—— 最常见，尤其改完composer.json就直接跑代码 - 路径写错，比如写成
"src/helpers.php"但实际是"src/Helpers.php"（大小写敏感，Linux/macOS 上必挂） - 文件里用了未声明的依赖，例如在
helpers.php里直接调用Illuminate\Support\Str::slug()，但illuminate/support并未安装或未 autoload - 函数文件里有
return、exit或顶层异常抛出，导致加载中途终止
函数文件不是“写完就跑”，它和类加载一样依赖 Composer 的构建流程；最容易被忽略的是：你改了文件内容，但没重新 dump autoload，或者路径大小写在不同系统上不一致——这类问题往往卡人半小时以上。
