autoload配置错误导致Class not found的根本原因是映射未被Composer读取或路径不存在；PSR-4要求autoload字段顶格置于composer.json顶层、命名空间末尾双反斜杠、路径相对且以/结尾、大小写与文件名严格一致，改后须运行composer dump-autoload验证。
autoload 配置写错一个字符，类就永远找不到——它不报语法错误，只默默返回 Class not found。根本原因不是 Composer 坏了，而是你写的映射没被它“读进去”，或者路径拼出来根本不存在。
PSR-4 映射必须顶格写在 composer.json 顶层
Composer 只认和 name、require 并列的 autoload 字段，缩进多一层、塞进 extra 或拼成 autoloader，全无效。
-
"autoload"键名必须原样拼写，大小写、下划线、连字符都不行 - 命名空间前缀末尾必须是双反斜杠：
"App\"✅，"App"❌，"App"（JSON 中实际只转义出一个 ）也 ❌ - 路径值只能是相对路径，且推荐以正斜杠结尾：
"src/"✅，"src"❌（否则可能拼出srcMyClass.php） - 路径不能以
/开头（如"/src/"），也不能含../或绝对路径
PSR-4 路径拼接是纯字符串操作，不扫描文件
给定类名 AppHttpControllersHomeController，Composer 会严格执行三步：
- 剥离命名空间前缀
App\→ 得到HttpControllersHomeController - 把剩余部分的反斜杠替换成正斜杠 →
Http/Controllers/HomeController - 拼上配置的路径
"src/"→ 最终路径是src/Http/Controllers/HomeController.php
差一个大小写（http ≠ Http）、少一级目录、类名和文件名不一致（HomeController.php ≠ homecontroller.php），就直接失败。
注意：namespace 声明行不能有前导空格或 tab；Linux/macOS 下路径大小写敏感，src/Utils/Helper.php 和 src/utils/helper.php 是两个不同文件。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
files 字段加载函数文件要特别小心路径和顺序
files 不走自动加载机制，而是无条件 require_once，但它只在 vendor/autoload.php 被引入时才触发。漏掉这行，函数永远不可用。
- 入口文件（如
index.php）必须第一行或至少在调用前包含：require __DIR__ . '/vendor/autoload.php'; -
files中的路径是相对于composer.json所在目录的，不是入口文件，也不是vendor/ - 必须带
.php扩展名："src/helpers.php"✅，"helpers.php"❌，"src/helpers"❌ - 多个文件按数组顺序
require_once，但 Composer 合并依赖时可能打乱顺序 —— A.php 依赖 B.php 定义的函数，却排在前面，就会报Call to undefined function - 避免重复定义：同一函数不能在两个
files里出现；也不要在files里放class定义，否则和 PSR-4 加载同名类冲突
改完 composer.json 必须手动运行 dump-autoload
vendor/autoload.php 是生成文件，不是配置源；vendor/composer/autoload_psr4.php 才是真正起作用的映射表，它不会自动更新。
- 开发阶段用
composer dump-autoload（不加-o），能暴露路径拼错、文件缺失等具体问题 -
composer dump-autoload -o会跳过运行时路径检查，把 PSR-4 映射固化为静态数组——配置错了反而更难定位 - 如果用了
autoload-dev（比如测试类），也要单独执行composer dump-autoload，它和autoload完全独立 - 运行后可快速验证：
var_dump(include 'vendor/composer/autoload_psr4.php');看数组里有没有你配的键值对
最常被忽略的一点：dump-autoload 不报错，不代表生效了——它只重写文件，不校验路径是否存在、类是否真能加载。最终路径是否真实存在、大小写是否完全匹配，得靠你亲手确认。
