files模式只无条件require_once指定的PHP文件，用于加载全局函数、常量等非类代码；需在composer.json中以相对路径配置autoload.files并执行dump-autoload生效。
files 加载模式到底在加载什么
files 是 Composer 的自动加载机制中唯一支持「非 PSR-4/PSR-0 类路径映射」的配置项，它不解析命名空间，也不检查类名，只做一件事：在 Composer 自动加载器初始化时，无条件 require_once 指定的 PHP 文件。这意味着它适合加载全局函数、常量定义、辅助工具函数集这类“无类”的代码文件。
如何正确配置 composer.json 的 files 字段
必须把函数文件路径写进 "autoload": { "files": [...] }，且路径是相对于 composer.json 所在目录的——不是相对于 vendor 或 src。常见错误是误用相对路径（比如写成 src/helpers.php 却把文件实际放在 lib/helpers.php）或用了绝对路径。
示例配置：
{
"autoload": {
"files": [
"src/functions.php",
"lib/constants.php"
]
}
}
配置完后必须运行 composer dump-autoload（或 composer install/update），否则变更不会生效。注意：files 不支持通配符（如 "*.php"），每个文件都得显式列出。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
为什么函数没被加载？排查这几点
- 文件里有语法错误（比如末尾少分号、用了新版本 PHP 特性但环境不支持），会导致
require_once失败，但 Composer 默认不报错——函数调用时才抛Fatal error: Uncaught Error: Call to undefined function - 文件中函数名与已加载的其他库冲突（例如两个
helpers.php都定义了str_slug()），PHP 会直接 fatal，且错误提示不指明来源文件 - 该文件被多次列入
files数组（或不同包重复声明），PHP 报Cannot redeclare xxx() - 使用了
composer install --no-autoloader或手动删了vendor/autoload.php，导致整个 autoloader 未启用
files 模式和性能、部署的关系
files 列表里的所有文件会在每次请求启动时被加载（只要引入了 vendor/autoload.php），不管其中的函数是否被用到。这对 CLI 工具影响小，但在 Web 请求中会带来轻微 IO 和解析开销——尤其是列表很长或文件很大时。
更隐蔽的问题是：这些文件在 composer install --optimize-autoloader（即生成 classmap）时仍会被无条件加载一次，用于检测是否有类定义（Composer 会跳过纯函数文件，但依然要打开并扫描）。所以不要把调试用的 dump() 或 exit 放在 files 文件里，否则 dump-autoload 会卡住或失败。
真正容易被忽略的是：一旦你把某个函数文件交由 files 管理，就等于把它和 Composer 生命周期绑定了——升级包、切换分支、甚至 CI 中清理 vendor 后忘记重装，都可能导致函数突然不可用，而错误现场往往不提示缺失的是哪个文件。
