autoload.files 是 Composer 唯一官方支持的全局函数自动加载方式；路径须为相对于 composer.json 的 .php 文件路径（如 "src/helpers.php"），修改后必须运行 composer dump-autoload，且入口文件首行需写 require __DIR__ . '/vendor/autoload.php';。
直接说结论： autoload.files 是 Composer 唯一支持全局函数自动加载的配置项，路径必须写成相对于 composer.json 的正斜杠结尾路径（如 "src/helpers.php"），改完必须手动运行 composer dump-autoload，且入口文件第一行得有 require __DIR__ . '/vendor/autoload.php';。
files 路径怎么写才不被 Composer 忽略
Composer 不解析 . 或 ..，也不接受绝对路径，只认从 composer.json 所在目录出发的相对路径：
-
"src/helpers.php"✅ —— 存在即加载 -
"./src/helpers.php"❌ ——.被静默跳过 -
"/src/helpers.php"❌ —— 开头/视为绝对路径，直接忽略 -
"src/helpers"❌ —— 缺.php扩展名，不会被识别 -
"src/*.php"✅ ——glob()支持单星号，但不支持"src/**/*.php"
为什么函数定义了却报 “Call to undefined function”
这不是 autoload 本身没生效，而是加载链断在了最前端：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 入口文件（如
public/index.php）没引入vendor/autoload.php，或路径写错（比如漏了vendor/） - 入口里写了
require 'vendor/autoload.php'—— 错！当前工作目录不确定，应始终用require __DIR__ . '/vendor/autoload.php'; - 框架（如 Laravel）重写了启动逻辑，但你把函数调用放在了
autoload.php引入之前（比如提前初始化了日志、DB） -
vendor/composer/autoload_files.php里没出现你的路径 → 说明dump-autoload没执行，或路径根本不存在
files 和 PSR-4 共存时要注意什么
它们不是“并列加载”，而是顺序触发：files 列表里的文件会在 autoloader 初始化时立刻 require_once，PSR-4 是按需懒加载。关键影响点在：
- 如果
files里定义了foo()，而某个 PSR-4 类里也include了同一文件 → 运行时报Cannot redeclare foo() - 多个
files条目之间有依赖（A.php 依赖 B.php 里定义的函数），但 B 在数组里排后面 → 启动就报错 - 文件里用了
declare(strict_types=1)，但调用了非严格兼容的函数（比如传string给期望int的参数）→ 加载中断，后续函数全不可用 - 文件里写了
class Helper {}→ 后续 PSR-4 加载同名类时会因重复定义失败
改了 files 为什么 dump-autoload 像没反应
它其实生效了，只是不报错、不提示，而且效果藏得深：
-
dump-autoload会重写vendor/autoload.php，把files路径硬编码进require_once链 —— 不是注册钩子，是直接写死 - 如果你的文件路径不存在，Composer 不报错，只静默跳过；检查
vendor/composer/autoload_files.php是否包含该路径是最准的验证方式 - CI/CD 中建议固定用：
composer install --no-dev && composer dump-autoload -o（-o对 files 有效，生成优化版 autoload.php） - 开发中别依赖
composer install自动触发 —— 它只在composer.lock变更时才顺带 dump，日常改files必须手动跑
最容易被忽略的是：files 加载是无条件、无作用域、无命名空间的 require_once。它不关心你在哪调用，只关心有没有被入口 require。一旦文件里有语法错误、strict_types 冲突、或重复声明，整个加载链就卡住，而错误往往出现在下游代码里，不是 autoload 本身报的。
