class not found但文件存在，先查autoload_psr4.php中是否有对应命名空间；若无，则因composer.json中autoload配置位置错误、命名空间末尾缺双反斜杠、路径非相对项目根目录、被git忽略、或大小写不匹配所致。
Class not found 但文件明明存在，先看 autoload_psr4.php 里有没有你的命名空间
运行 composer dump-autoload -v 后，直接打开 vendor/composer/autoload_psr4.php，用 Ctrl+F 搜索你的命名空间前缀（比如 'App\'）。如果没出现，说明配置压根没被识别——不是类写错了，是 composer.json 里那行 PSR-4 映射根本没生效。
常见静默失败点：
-
"autoload"键写在了scripts或config下，Composer 直接忽略 - 命名空间末尾漏了双反斜杠：
"App": "app/"❌ 应为"App\": "app/"✅（JSON 解析后"App"变成无尾缀字符串，PSR-4 匹配失败） - 路径用了
./app/或绝对路径，PSR-4 只接受项目根目录下的相对路径，且末尾必须带/ - git 忽略了该目录（如
app/在.gitignore里），dump-autoload默认跳过被忽略路径
文件路径、命名空间、类名三者大小写不一致，在 Linux 下必报错
Linux 文件系统大小写敏感，而 Windows/macOS 默认不敏感。你在 Windows 上把 src/Utils/Helper.php 写成 src/utils/helper.php 可能“跑得通”，一上 Linux 就崩：PHP 找不到 UtilsHelper，因为实际路径是小写的 utils。
验证方式很直接：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 终端执行
ls -l src/Utils/Helper.php，确认真实路径拼写 - 打开文件，检查
namespace声明是否与目录结构完全对应（namespace App\Http\Controllers;→ 路径必须是app/Http/Controllers/，不能是app/http/controllers/） - 类名必须和文件名完全一致：
class UserController→ 文件必须叫UserController.php，不是usercontroller.php或UserControllerController.php - IDE 重命名类时，务必同步改文件名；否则 Git 在 Linux 下可能根本不记录变更（
core.ignorecase = true是默认行为）
用了 files 自动加载，路径大小写错一个字母就 require 失败
files 字段是硬路径直引，不走任何映射逻辑。写成 "App/Helpers/Helper.php"，但磁盘上实际是 app/Helpers/Helper.php，就会在 composer dump-autoload 阶段直接报错：Failed to open stream: No such file or directory。
正确做法：
- 路径全部用小写，符合 Laravel 和 PSR 社区惯例：
"app/Helpers/Helper.php" - 路径是相对于
composer.json所在目录的，不能含../或绝对路径 - 改完后必须重新运行
composer dump-autoload（或install/update），否则不会更新vendor/autoload.php中的require列表 - 加一层防御：在
Helper.php开头用function_exists()包裹函数定义，避免重复引入时 fatal error
改了配置但类还是找不到，先清掉旧映射再重 dump
有时 composer dump-autoload -o 看似成功，但旧的 autoload_classmap.php 仍残留已删除类的路径，导致 PHP 去找一个不存在的文件；或者 OPcache 缓存了旧的自动加载逻辑。
临时验证最有效：
- 删掉整个
vendor/composer/autoload_*.php文件 - 运行
composer dump-autoload --no-optimize（强制只走 PSR-4 实时推导，绕过 classmap 干扰） - 再执行
var_dump(class_exists('App\Services\UserService'))，返回false就说明问题还在映射层，不是代码或引入问题 - 确认入口脚本第一行是
require __DIR__ . '/vendor/autoload.php';，且前面没有任何输出（包括 BOM、空格、echo）
Class not found 就会准时出现——而且它不告诉你哪一环坏了。
