composer 不自动加载函数文件，需通过 autoload.files 显式声明并运行 composer dump-autoload；文件在每次引入 vendor/autoload.php 时即执行，不支持按需加载，且顺序影响覆盖行为。
Composer 不会自动加载普通 PHP 函数文件，必须通过 autoload.files 显式声明，否则函数未定义（Fatal error: Uncaught Error: Call to undefined function）。
为什么 require 自定义函数文件后仍报错？
常见原因是：你手动 require 了文件，但 Composer 的自动加载机制根本没参与——这和 Composer 无关；或者你改了 composer.json 却没运行 composer dump-autoload，导致新配置未生效。
- Composer 只在执行
composer install或composer dump-autoload时生成vendor/autoload.php中的加载逻辑 -
autoload.files列表里的文件会在每次require 'vendor/autoload.php'时被无条件 include（不依赖命名空间或类名） - 函数名冲突不会报错，后加载的会覆盖先加载的——注意文件顺序
如何用 autoload.files 加载 helpers.php
在项目根目录的 composer.json 中添加：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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"
]
}
}
然后运行：
composer dump-autoload
- 路径是相对于
composer.json的，不能用./src/helpers.php或绝对路径 - 多个文件按需加载顺序排列，比如先
constants.php再helpers.php - 修改后务必重新 dump，否则代码里调用函数仍会报错
autoload.files 和 PSR-4 混用时要注意什么？
两者互不干扰，但行为完全不同：autoload.files 是“全量加载”，PSR-4 是“按需加载类”。如果你把工具函数写成类方法（推荐），就该走 PSR-4；如果坚持用全局函数，就只能靠 files。
- PSR-4 不加载函数，哪怕文件里混写了函数，也不会触发自动包含
- 不要试图在 PSR-4 类文件里写全局函数并指望它被自动加载——不可靠，也不符合规范
- 函数文件一旦加入
autoload.files，每次请求都会执行，注意副作用（如重复定义常量、执行初始化逻辑）
真正容易被忽略的是：函数文件里的代码会在 Composer 自动加载阶段立即执行，不是“调用时才加载”。所以别在里面写 echo、exit 或依赖未初始化的上下文（比如 Laravel 的 app() 还没启动）。
