autoload.files是Composer唯一支持函数自动加载的机制，必须嵌套在"autoload": {"files": [...]}中，路径须相对composer.json且为真实.php文件，修改后需手动执行composer dump-autoload生效。
autoload.files 是 Composer 唯一支持函数自动加载的机制，不是“推荐方式”，而是唯一合法路径。PSR-4、classmap、甚至 autoload-dev 下的其他配置，统统不处理函数——写进去也完全无效。
autoload.files 必须写在 composer.json 的正确位置
files 数组不能单独存在，也不能放在 autoload-dev 外层或根级。它必须嵌套在 "autoload": { "files": [...] } 里：
-
✅ 正确：
{ "autoload": { "files": [ "src/helpers.php", "src/constants.php" ] } } ❌ 错误：
"files": [...]（顶层字段，Composer 忽略）"autoload-dev": { "files": [...] }（只在 dev 环境生效，且需确认是否安装了 dev 依赖）"autoload": { "psr-4": {...}, "files": [...] }（语法合法，但顺序无关——files总是最后被 require，和 PSR-4 注册时机无关）
路径必须相对于 composer.json 所在目录，且必须是真实存在的 .php 文件：
-
"src/helpers.php"✅ -
"./src/utils.php"✅ -
"helpers.php"❌（当前工作目录不可控，CI/部署易失败） -
"src/"❌（是目录，不是文件） -
"src/*.php"✅（Composer ≥ 2.2 支持，但通配结果里不能含非 PHP 文件）
修改后必须手动执行 composer dump-autoload
Composer 不监听 composer.json 变更，也不在 install 或 update 时强制重生成 autoload 文件（除非你显式加 --optimize-autoloader 或配置了 "optimize-autoloader": true）。
运行命令后，检查是否生成了 vendor/composer/autoload_files.php，里面应有类似内容：
return array( __DIR__ . '/..' . '/src/helpers.php', __DIR__ . '/..' . '/src/constants.php', );
常见失效原因：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 没运行
composer dump-autoload - 路径写错或文件实际不存在（Composer 静默跳过，不报错、不警告）
- Web 环境下 opcache 缓存了旧的
autoload_files.php，需调用opcache_reset()或重启 PHP-FPM - CLI 下当前 shell 不在项目根目录，导致
composer dump-autoload生效于错误位置
files 加载的文件里能写什么、不能写什么
files 中的每个文件会在 vendor/autoload.php 被 require 时，按数组顺序无条件 require_once —— 注意：这个 require_once 是 Composer 自己写的硬编码逻辑，你文件内部再写 require_once 没用，还可能引发重复加载。
允许的内容（纯声明、无副作用）：
-
function str_slug($s) { return preg_replace(...); } -
define('APP_DEBUG', true); class_alias('OldClass', 'NewClass');
禁止的内容（副作用、运行时依赖、环境假设）：
-
echo 'init';（Web 请求/队列 worker 启动时直接输出，破坏 JSON 响应） -
new PDO(...)（DB 配置可能未加载，连接失败即 fatal） -
file_get_contents(<strong>DIR</strong> . '/config.json')（文件可能不存在，或权限不足） -
$_ENV['DB_HOST']（$_ENV在某些 SAPI 下为空，且加载时机早于 dotenv 初始化） -
function foo() { return new SomeService(); }（SomeService类此时尚未注册进 autoloader，new直接报 Class not found）
特别注意：
- 若两个
files条目都定义了同名函数，后加载的会覆盖前一个，触发Fatal error: Cannot redeclare - 所有
files文件在 PSR-4 映射注册之后、但在任何类首次实例化之前执行，所以你可以在 PSR-4 类的方法里安全调用这些函数，但不能在files里new那些类
测试时函数找不到？大概率没引入 vendor/autoload.php
很多测试脚本（尤其是 PHPUnit 单独跑 php test.php）不会自动加载 Composer autoloader。现象是 IDE 显示函数存在，运行却报 Call to undefined function。
解决方法很简单：
- 确保测试文件开头有：
require <strong>DIR</strong>.'/../vendor/autoload.php'; - 如果用
phpunit.xml，检查<phpunit bootstrap="...">是否指向了正确的入口（通常是vendor/autoload.php） - 不要在测试中依赖“某个包已加载了 autoloader”——它不可靠，显式引入最稳
真正容易被忽略的是：函数文件一旦开始读环境变量、连数据库、或依赖其他类，它就不再是“全局工具函数”，而成了初始化逻辑的一部分。这种代码不该塞进 files，该封装成服务，由容器控制生命周期。
