class not found 主因是类未被 composer 扫入自动加载表；应先运行 composer dump-autoload -v 查看扫描详情，确认目标类名是否出现在输出中，并检查 autoload_classmap.php 或 autoload_psr4.php 是否包含该类，再比对路径、命名空间、文件名三者是否严格一致。
新建类文件后 Class not found，不是代码写错了，而是 Composer 没把它扫进自动加载映射表——最直接的解决路径是确认它是否出现在 vendor/composer/autoload_classmap.php 或 autoload_psr4.php 里，而不是反复改命名空间或删缓存。
composer dump-autoload -v 是排查第一步
不加 -v 就跑 dump-autoload，等于蒙眼调试。加了才能看到真实扫描行为：
- 输出里有没有出现你的类名（如
AppServicesUserService）？没出现说明根本没被读到 - 有没有类似
Adding PSR-4 autoload rule for App\: app/的提示？没有就代表composer.json里"App\": "app/"写成了"App": "app/"（缺末尾反斜杠） - 某个目录完全没在输出中出现？回头检查 JSON 格式：字段名是不是拼错（比如写成
class_map）、缩进用了 tab、末尾多了一个逗号 - 是否跳过了你的 PHP 文件？
-v会告诉你“skipped: no class found”或“syntax error”，说明文件本身有问题
autoload_classmap.php 不存在或为空？说明没走对流程
composer dump-autoload -o 在 Composer 2.x + PHP 7.4+ 下多数时候不生成 autoload_classmap.php，它只刷新 autoload_static.php 和 PSR-4 映射，classmap 文件只在 install 或 update 阶段重建。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 执行完
dump-autoload -o后，检查vendor/composer/autoload_classmap.php是否存在、是否远超几十行（几千行才算有效） - 如果文件不存在或为空，说明项目没配置
"classmap"字段，也没触发 install 流程 —— 此时-o是假优化 - 真正该跑的是
composer install --no-dev --optimize-autoloader，它强制基于当前composer.json重新生成 classmap - CI/CD 脚本里写
dump-autoload -o而非install --optimize-autoloader，是线上 autoload 失效的常见原因
PSR-4 路径、命名空间、文件名三者必须逐级严格匹配
PSR-4 不是字符串替换，而是按层级截断+转小写+拼路径。哪怕一个字母大小写不对，就找不到。
- 若
composer.json中配置为"App\": "app/"，则App\Http\Controllers\UserController必须落在app/Http/Controllers/UserController.php - 文件名必须与类名全字符一致：
UserController.php→class UserController，不是usercontroller也不是Usercontroller - Linux 下路径大小写敏感：
app/http/controllers/≠app/Http/Controllers/，前者会导致 fallback 失败 - 命名空间声明必须带结尾反斜杠：
namespace App\Http\Controllers;正确，namespace App\Http\Controllers（缺分号前的;）或namespace AppHttpControllers;（中间缺反斜杠）都会失败
--classmap-authoritative 开了就报错？先查 classmap 是否漏类
--classmap-authoritative 不是加速开关，是“断电式加载”：类不在 classmap 里就立刻抛 Class not found，不再 fallback 到 PSR-4 查找。
- 报错不是配置错，是 classmap 没覆盖到这个类 —— 新增类后忘了重新跑
composer install --no-dev --optimize-autoloader - 检查
autoload_classmap.php里有没有你的类名；没有，就说明扫描阶段被跳过，常见原因是 PSR-4 前缀末尾缺反斜杠，或类文件放在未声明的目录下（比如临时加了app/utils/Helper.php，但app/utils/没进任何 autoload 配置） -
"files"类型加载的全局函数（如"files": ["app/Helpers/functions.php"]）不会进 classmap，开了--classmap-authoritative后它们仍能工作，别误以为 autoload 整体失效 - 本地开发慎用此参数：Tinker、PHPUnit 临时类、IDE 补全都可能崩；只应在部署前验证并固化到 CI/CD
最容易被忽略的一点：autoload_classmap.php 一旦生成，就不会因为删了类文件而自动清理。它里面还留着已删除类的路径，class_exists() 仍返回 true，但实际 new 时会报 include(): failed to open stream。真要验证 classmap 是否生效，得删文件 + 看报错类型，而不是只信 class_exists 返回值。
