files字段路径必须是相对于composer.json的纯相对路径，如"src/helpers.php"；禁止./、../或绝对路径；文件须真实存在且无语法错误，修改后需运行composer dump-autoload。
composer.json里files字段路径怎么写才不报错
路径必须是相对于composer.json所在目录的纯相对路径，不能带./或../，也不能是绝对路径。Composer 不解析点号，遇到就静默跳过，不会报错也不会提示。
正确写法示例："src/helpers.php"、"app/Functions/constants.php"、"legacy/utils.php"
错误写法示例："./src/helpers.php"（开头.被忽略）、"../shared/functions.php"（跨出项目根，被拒绝）、"src/helpers"（缺.php扩展名，不加载）
常见陷阱：
- 路径指向的文件必须真实存在且可读，否则
composer dump-autoload不会失败，但vendor/composer/autoload_files.php里不会出现它 - 通配符只支持
*，如"src/Helpers/*.php"合法；"src/**/*.php"非法（glob()不支持双星号递归） - 路径里不能有空格或中文（某些系统下
glob()行为异常，建议规避）
为什么files配置了却提示Call to undefined function
最常见原因不是配置错，而是vendor/autoload.php根本没被入口文件引入，或者引入时机太晚。
必须确保：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Web 入口（如
public/index.php）第一行是require __DIR__ . '/../vendor/autoload.php';，不能是require 'vendor/autoload.php'（当前工作目录不可控） - CLI 脚本也得显式
require，不能依赖框架自动加载——autoload.files不走 PSR-4 或类加载机制，只靠autoload.php被require那一刻触发require_once - 检查
vendor/composer/autoload_files.php是否包含你写的路径——如果没有，说明composer dump-autoload没执行，或路径在文件系统中根本不存在
files数组里多个PHP文件的加载顺序和冲突风险
数组顺序只是声明顺序，实际加载顺序由 Composer 内部合并逻辑决定，尤其是当多个包（包括你require的第三方库）都定义了files时，最终顺序不可预测。
更关键的是：所有files里的 PHP 文件都会被require_once，一旦其中某个文件语法错误、exit或die，整个 autoload 流程就中断，连后续类都加载不了。
函数重复定义会直接报致命错误：Fatal error: Cannot redeclare my_helper()。所以：
- 避免在多个
files中定义同名函数 - 函数文件里只放
function和const定义，不要写执行逻辑、echo、header()等副作用代码 - 如果需要条件加载，改用函数内判断，而不是靠文件加载顺序控制
修改files后为什么函数还是没生效
改完composer.json不运行composer dump-autoload，等于没改。这个命令才是把files列表写进vendor/autoload.php和vendor/composer/autoload_files.php的关键步骤。
注意：
-
composer install或composer update也会触发生成，但如果你只是改files而没动require，它们不一定重新生成 autoload 文件（取决于锁文件和本地缓存） - 推荐每次改完就手动跑一次
composer dump-autoload，加-v参数看输出，确认你的文件是否出现在“Generated autoload files”日志里 - 如果用了 Docker 或部署脚本，确保
dump-autoload是在目标环境执行的，不是本地生成后复制过去——路径是相对于容器内composer.json位置的
最容易被忽略的一点：文件路径对，dump-autoload也跑了，入口require也没问题，但函数仍不可用——大概率是那个 PHP 文件本身有语法错误，或者定义函数前用了namespace（files加载的是全局作用域，加namespace会导致函数落在命名空间里，调用时得带前缀）。
