composer.json 的 files 字段必须指向包内真实路径：路径需相对于包根目录、大小写敏感、文件需可读；函数定义须用 function_exists() 单独包裹；测试需确保 vendor/autoload.php 被加载；发布后使用者无需手动 dump-autoload，但作者更新 files 后须自行执行并提交。
composer.json 的 files 字段必须指向包内真实路径
开发 Composer 扩展包时，全局辅助函数不能靠“放对位置”蒙混过关——composer.json 中 "files" 数组填的路径，是相对于该包自身根目录（即 composer.json 所在处）的相对路径，不是相对于使用它的项目。
常见错误包括：
- 写成
"src/helpers.php"，但实际文件在src/Support/helpers.php - 路径大小写不一致，比如包里是
Helpers.php，配置写了helpers.php（Linux/macOS 下直接失效） - 路径存在但文件权限为只读，
composer dump-autoload不报错，但运行时require_once失败，函数不可用
验证方式：进入包目录执行 ls -l src/helpers.php，确保输出真实存在且可读；再检查 vendor/your-vendor/your-package/composer.json 里的 files 路径是否与之完全匹配。
function_exists() 判断必须包裹每个函数定义
扩展包被多个项目或多个包同时 require 时，files 加载机制会触发多次 require_once —— 但 Composer 并不保证加载顺序，也不拦截重复声明。一旦两个包都定义了 str_slug()，就会抛出 Fatal error: Cannot redeclare str_slug()，错误堆栈往往指向 vendor/composer/ClassLoader.php，根本看不出源头。
正确写法是每个函数单独包裹判断：
if (!function_exists('my_package_helper')) {
function my_package_helper($value) {
return 'processed: ' . $value;
}
}
不要图省事写一个大括号包所有函数——PHP 解析器会在 function_exists() 检查前就尝试编译所有 function 声明，照样报错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
测试环境里函数找不到？确认 PHPUnit 是否加载了 vendor/autoload.php
本地开发时函数可用，但跑 PHPUnit 就报 Call to undefined function，大概率是测试启动流程没走 Composer 自动加载入口。
典型原因有：
-
phpunit.xml中未配置bootstrap="vendor/autoload.php" - 用了
ParaTest或自定义测试 runner，但没显式引入vendor/autoload.php - 在测试文件里手动
require 'src/helpers.php'，绕过了 Composer 的files机制，导致函数只在测试文件作用域生效
最稳的验证方式：在测试方法开头加 var_dump(get_included_files());，确认 vendor/composer/autoload_files.php 和你的 helpers 文件都在列表里。
发布后使用者要执行 dump-autoload 吗？不需要，但要注意 autoload.files 是“安装时固化”的
你在包里写了 "files": ["src/helpers.php"]，使用者执行 composer require your/package 时，Composer 会自动把该路径合并进他们项目的 vendor/composer/autoload_files.php —— 这步由 Composer 完成，无需使用者手动 dump-autoload。
但注意两个边界情况：
- 如果使用者用的是
composer install --no-autoloader，那autoload_files.php根本不会生成，函数自然不可用 - 如果你在包后续版本中新增了一个 helper 文件，比如加了
"src/extra_helpers.php"，使用者升级后必须运行composer dump-autoload（或composer update），否则新文件不会被加入已生成的autoload_files.php
真正容易被忽略的是：包作者自己改了 composer.json 后，必须在包目录下运行 composer dump-autoload，再提交代码——否则别人 composer require 的是旧版自动加载逻辑。
