laravel 10 出现 class not found 错误主因是自动加载未更新、命名空间与路径不匹配（如 appmodelsuser 必须对应 app/models/user.php）、大小写敏感、依赖误用 composer install 而非 composer require，或升级后服务提供者未重新发现。
Laravel 10 安装后提示 Class not found，多数情况不是框架本身损坏，而是自动加载或命名规范没对齐。Laravel 10 默认启用延迟服务提供者发现（Lazy Provider Discovery），同时对 PSR-4 映射、类名大小写、命名空间路径的要求更严格，稍有偏差就会触发该错误。
命名空间与文件路径不匹配
Laravel 严格遵循 PSR-4：类的命名空间必须和物理路径完全对应，且大小写敏感。
- 例如
AppModelsUser必须放在app/Models/User.php，不能是user.php或Users.php - 若自定义目录（如
Enums或Services），需在composer.json的"autoload": {"psr-4"}中显式声明，并运行composer dump-autoload - 检查
vendor/composer/autoload_psr4.php是否已包含你的命名空间映射
依赖安装方式错误
用 composer install 手动添加新包（如 laravel/sanctum）会导致包进 vendor/，但不会写入 composer.json，也不会更新自动加载映射。
- 正确做法是始终使用
composer require vendor/package，它会自动完成写配置、下载、刷新 autoload 三步 - 若已误操作，先补全
composer.json的require字段，再执行composer update vendor/package或composer dump-autoload
升级或迁移遗留问题
从旧版（如 Laravel 8/9）升级到 10 后，部分类引用方式已变更，容易被忽略。
-
IlluminateFoundationAuthUser是标准基类，写成users（小写）或Authusers会直接报错 - 服务提供者不再仅靠
config/app.php的providers数组加载；需确认包是否在composer.json的extra.laravel.providers中注册，或运行php artisan package:discover - 缓存未清：执行
php artisan config:clear、php artisan cache:clear和composer dump-autoload
枚举或 PHP 8.1+ 特性未适配
Laravel 10 原生支持 PHP 8.1 枚举，但默认只加载 app/ 下内容。
- 把
Enums/Status.php放在项目根目录（同app/平级）会导致自动加载失效 - 应放入
app/Enums/Status.php，并声明命名空间AppEnums，同时在composer.json补充"App\Enums\": "app/Enums/" - 确认 PHP 版本 ≥ 8.1，且
opcache.enable未导致类定义缓存未刷新
