composer自动加载失败主因是autoload配置错误、vendor/autoload.php未引入、psr-4路径不匹配或未执行dump-autoload；需确保autoload为顶级字段、命名空间带反斜杠、路径正确、入口文件引入自动加载器，并及时刷新缓存。
autoload 配置没生效：检查 composer.json 的 autoload 字段
Composer 自动加载失败，第一反应不是代码写错了，而是 composer.json 里写的路径压根没被加载。常见问题是把 "psr-4" 或 "classmap" 写在了错误位置（比如写在了 "require" 下面但没缩进对齐），或者用了相对路径却没以 ./ 开头。
- 确保
autoload是顶级字段，和require并列 - PSR-4 映射的命名空间末尾必须带反斜杠，例如
"App\": "src/"，不能写成"App": "src/" - 如果用
classmap，路径必须指向实际存在且含类定义的 PHP 文件，目录需可读，且执行过composer dump-autoload
vendor/autoload.php 没被引入：确认入口文件是否 require 它
很多新手写完 composer install 就以为万事大吉，结果运行脚本时直接报 Class not found。根本原因是没在入口 PHP 文件（比如 index.php 或测试脚本）里显式引入自动加载器。
- 必须在使用任何 Composer 包或自定义类前，执行
require <strong>DIR</strong> . '/vendor/autoload.php'; - 路径要写对：
vendor/autoload.php是相对于当前执行脚本的位置，不是相对于项目根目录 - 不要依赖框架隐式加载——纯 PHP 脚本、命令行工具、单元测试启动文件都得自己加这行
命名空间与文件路径不匹配：PSR-4 规则被违反
PSR-4 不是“模糊匹配”，它严格按命名空间层级对应目录结构。比如配置了 "App\": "src/"，那么 new App\Http\Controller\HomeController 就必须对应 src/Http/Controller/HomeController.php，少一层目录、多一个下划线、大小写不一致都会失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 文件名必须和类名完全一致（包括大小写），PHP 在 Linux 上区分大小写
- 类声明里的命名空间必须和文件路径推导出的一致，不能靠 IDE 自动生成就默认正确
- 使用
composer dump-autoload -o后，可以临时删掉vendor/composer/autoload_psr4.php查看映射关系是否符合预期
修改后没刷新自动加载缓存：忘记运行 dump-autoload
改完 composer.json 或新增类文件后，Composer 不会自动重生成映射表。尤其在开发中频繁增删类，很容易卡在“明明写了类却找不到”的状态。
- 运行
composer dump-autoload强制重建自动加载规则 - 加上
-o参数启用优化模式（生成 classmap 缓存），适合生产环境，但开发中调试建议先不用，避免掩盖路径问题 - 如果用了
composer install --no-autoloader或 CI 环境跳过了 autoload 生成，也要手动补上dump-autoload
自动加载失败真正难排查的点，往往不在语法或拼写，而在路径解析的“隐式假设”——比如认为 src/ 是相对于 composer.json，其实它是相对于当前工作目录；又比如改了命名空间但忘了同步改文件位置。这类问题不会报错提示，只会静默失败。
