files字段必须写在"autoload"对象下，路径为相对于composer.json的真实相对路径（如"src/helpers.php"），文件须存在且为.php扩展；修改后需执行composer dump-autoload，并确保入口文件显式引入vendor/autoload.php。
composer.json 里 files 字段怎么写才生效
必须写在 "autoload" 对象下，不能写成 autoload.files（这个键根本不存在）。路径是相对于 composer.json 所在目录的**真实相对路径**，且文件必须存在、可读。
常见错误包括：
- 路径用了
./src/helpers.php——./是多余的，直接写"src/helpers.php" - 路径跨出项目根，比如
"../shared/functions.php"—— Composer 会静默跳过 - 写了通配符如
"src/*.php"—— 多数 Composer 版本不支持，只认具体文件路径 - 文件扩展名不是
.php，或内容实际是空/只有注释/只有 class 定义 —— 函数不会被注册
正确示例：
{
"autoload": {
"files": [
"src/helpers.php",
"app/Support/str_helpers.php"
]
}
}
改完 composer.json 为什么函数还是找不到
因为 Composer 不监听文件变化，composer.json 修改后不会自动重写加载逻辑。必须手动触发生成：
- 运行
composer dump-autoload（开发时推荐加-o优化） - 或者执行
composer install/composer update（部署常用）
验证是否写入成功，可以打开 vendor/composer/autoload_files.php，看你的路径是否出现在数组里。如果没出现，说明路径错、文件不存在，或没执行 dump 命令。
另一个高频原因：入口文件（如 index.php 或 PHPUnit 的 bootstrap）没显式 require 'vendor/autoload.php'。Composer 的 files 不是“全局注入”，它只在 autoload.php 被 require 时才批量 require_once 那些 PHP 文件。
为什么 CLI 下能用，Web 请求报 Call to undefined function
本质是 Web 入口漏掉了 require 'vendor/autoload.php'，或路径写错（比如少写了 vendor/ 前缀）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
CLI 和 Web 环境完全独立，PHP 配置、工作目录、入口脚本都不同。即使你在命令行跑 php test.php 并手动 require 了 autoload，也不代表 Apache/Nginx 运行的 index.php 也这么做了。
检查点：
- Web 入口（如
public/index.php）第一行是否为require __DIR__.'/../vendor/autoload.php'; - 路径大小写是否一致（Linux 下
Helpers.php≠helpers.php） - 文件权限是否允许 Web 用户读取（尤其是
src/helpers.php）
快速验证技巧：在你要加载的 PHP 文件开头加 echo "helpers loaded\n";，然后访问页面或跑 CLI 脚本，看有没有输出 —— 有输出说明路径和加载流程通了。
files 和 PSR-4 共存时要注意什么
两者可以共存，但加载时机和行为差异很大：
-
files是「启动即加载」：只要vendor/autoload.php被 require，所有files列表里的文件就立刻require_once一遍，不管里面函数你用不用 -
psr-4是「按需加载」：类第一次被 new 或静态调用时，才去查映射、找文件、include
这意味着：
- 不要在
files加载的文件里直接new App\Services\DB()—— 此时 PSR-4 映射可能还没注册，会报 Class not found - 避免在
files文件里做耗时操作（如扫描目录、连接数据库），它会在每次请求/脚本启动时执行 - 函数定义顺序很重要：如果
a.php依赖b.php里定义的函数，那b.php必须写在files数组前面 - 函数无法被命名空间隔离，也无法被 IDE 友好识别 —— 它们就是裸函数，一旦重定义就会 Fatal error
真正容易被忽略的是：files 加载的函数没有作用域边界，调试时很难追溯来源，出问题也难 mock 或替换。小工具函数适合它，复杂逻辑建议封装进类里走 PSR-4。
