autoload.files 是唯一靠谱方案，因为 Composer 无全局函数自动加载机制，files 配置通过提前 require 函数文件实现“伪自动加载”，仅此方式支持函数、常量及副作用代码，且必须用相对路径逐个列出、运行 dump-autoload 生效。
为什么 autoload.files 是唯一靠谱方案
Composer 没有“全局函数自动加载”的独立机制，所有函数必须显式包含（require 或 include）才能被 PHP 识别。所谓“自动加载全局函数”，本质是让 Composer 在每次 composer autoloader 初始化时，**提前 require 一批 .php 文件**——这正是 autoload.files 的设计目的。
你不能指望 classmap 或 psr-4 加载函数文件，它们只处理类、接口、trait；也不能把函数塞进类里再用静态方法模拟，那已经不是“全局函数”了。
- 在
composer.json的"autoload"下添加"files"数组 - 路径必须是相对于
composer.json的相对路径（不是相对于当前工作目录） - 文件内只能定义函数、常量、执行副作用代码（如
define()），不能有顶层逻辑（如直接调用函数） - 修改后必须运行
composer dump-autoload才生效，否则新文件不会被写入vendor/autoload.php
composer.json 中的 files 配置怎么写才不报错
常见错误是路径拼错或用了绝对路径。Composer 不接受 __DIR__、realpath() 这类动态写法，也不支持通配符（*.php）——必须逐个列出文件。
示例正确配置：
{
"autoload": {
"files": [
"src/helpers.php",
"src/constants.php"
]
}
}
如果文件在 vendor/ 外但不在项目根目录下（比如放在 app/Support/），就写 "app/Support/functions.php"；若误写成 ../app/Support/functions.php 或 /full/path/functions.php，composer dump-autoload 会静默跳过该条目，且不报错——这是最易被忽略的坑。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 路径中不要出现
./前缀（Composer 会认为是非法路径） - 文件必须真实存在，且 PHP 语法合法；否则
dump-autoload可能失败并提示 “syntax error” - 多个文件按加载顺序排列，依赖关系强的放后面（比如
constants.php应在helpers.php前）
加载后函数仍找不到？检查这三个点
即使 composer dump-autoload 成功，运行时仍报 Call to undefined function，大概率卡在这三处：
- 没在代码入口处
require 'vendor/autoload.php'—— 这是前提，漏掉就完全没走 Composer 的 autoload 流程 - 函数文件里用了命名空间但没加
function my_func() { ... }（即没声明为全局作用域），结果函数实际定义在某个 namespace 下，调用时自然找不到 - CLI 和 Web 环境的当前工作目录不同，导致某些硬编码路径（比如文件内
require 'config.php'）失败，间接让函数定义没执行完
快速验证是否加载成功：在函数文件开头加一行 echo "helpers loaded";，然后执行脚本——如果没输出，说明该文件根本没被 include 进来。
性能和维护上容易被低估的代价
autoload.files 是“每次请求都加载”，不像类加载那样按需触发。哪怕你只调用一个函数，整个 helpers.php 也会被完整解析执行一次。
- 文件越大、副作用越多（比如初始化连接、读取配置），启动开销越明显，尤其对 CLI 命令或短生命周期脚本影响直接
- 函数之间耦合变隐性：A 函数依赖 B 函数，但两者在不同文件里，
autoload.files的顺序一旦调换，运行时才暴露问题 - IDE（如 PHPStorm）无法静态分析跨文件函数调用，补全和跳转经常失效
真正需要大量全局函数的项目，建议尽早收敛到单个文件，并在顶部加 declare(strict_types=1); 和文档块，比分散管理更可控。
