files配置必须写在composer.json的autoload字段中，不能修改vendor/autoload.php；路径须为相对于composer.json的明确php文件路径，修改后必须执行composer dump-autoload生效。
files配置必须写在composer.json的autoload字段里
直接改vendor/autoload.php没用，它每次都会被覆盖。所有规则必须声明在项目根目录的composer.json中autoload字段下。
常见错误是把路径写成绝对路径、带./前缀，或误以为能用通配符——files只接受明确列出的PHP文件路径，且全部以composer.json所在目录为基准。
-
"src/helpers.php"✅ 正确：相对路径，存在且是PHP文件 -
"/var/www/project/src/helpers.php"❌ 绝对路径，Composer会忽略 -
"./src/helpers.php"❌./不是必需的，反而容易因环境差异出错 -
"src/Helpers/*.php"❌ 不支持通配符，每个文件必须单独写
修改后必须运行composer dump-autoload
Composer不会监听文件变化，也不会在composer install时自动重生成映射。只要改了composer.json里的files数组，就必须手动执行：
composer dump-autoload
否则新函数永远不可用，报Call to undefined function。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 开发阶段建议不用
-o（optimize），避免优化版缓存掩盖路径错误 - 上线前可加
composer dump-autoload -o提升性能，但files仍走独立require_once流程，不受影响 - 如果用了
autoload-dev（比如测试用的辅助函数），要单独执行composer dump-autoload --dev
函数定义要防重复声明
files加载的文件会在框架启动时被require_once一次，但如果你在测试或路由逻辑里又手动require同一文件，就会触发Fatal error: Cannot redeclare function。
真正安全的写法是在函数定义前加function_exists检查：
if (!function_exists('my_helper')) {
function my_helper() { /* ... */ }
}
- 别把函数定义在
if条件块里（如if (DEBUG) { function foo() {} }），加载时条件不满足，函数根本不会注册 - 避免在
files文件里直接new AppServicesSomeService()，因为PSR-4类此时可能还没注册，会报Class not found - 若函数依赖某个类，用
class_exists('App\Services\SomeService')做懒检查，而不是直接实例化
测试中函数找不到？确认是否加载了vendor/autoload.php
PHPUnit等测试框架默认只加载vendor/autoload.php，但如果你没在测试启动流程里显式引入它，或者phpunit.xml里bootstrap配置错了路径，函数就不可见。
- 检查
phpunit.xml中是否有类似<bootstrap>vendor/autoload.php</bootstrap> - 不要在测试文件里手动
require 'src/helpers.php'——这绕过了Composer机制，还可能引发重复定义 - 并行测试工具（如ParaTest）可能隔离autoloader环境，需确认其文档是否要求额外配置
真正容易被忽略的是：files加载是「启动即执行」，不是按需加载。函数一旦放进这个列表，就脱离命名空间、无法被use、IDE难追踪，出问题时也很难定位到加载源头。
