直接执行 composer dump-autoload -o 能解决 70% 的 Class not found 报错，但前提是你的命名空间、路径、文件名三者已经对齐——否则刷新自动加载只是在错误的轨道上跑得更快。
命名空间和文件路径必须严格一一对应
PSR-4 不是“大概匹配”，而是字符串级精确映射。比如报错 Class AppHttpControllersUserController not found，就表示自动加载器去查 AppHttpControllers 这个命名空间对应的目录，然后拼出 UserController 类名找文件。
- 确认
UserController.php真实路径是app/Http/Controllers/UserController.php（注意大小写，Linux 下usercontroller.php≠UserController.php） - 打开该文件，检查第一行是否为
namespace AppHttpControllers;（末尾分号不能少，且不能多空格或换行） - 类定义必须是
class UserController，不能是class usercontroller、class UserController1或class UserController extends BaseController拼错基类名 - Windows 开发时路径看着对，部署到 Linux 服务器后立即崩，大概率是大小写不一致导致的
composer.json 的 autoload 配置不能有隐藏错误
哪怕只多一个空格、少一个反斜杠，Composer 就不会把你的命名空间注册进 vendor/composer/autoload_psr4.php。
- 检查
composer.json中"autoload"段是否包含类似："psr-4": { "App\": "app/" }（注意：命名空间末尾是双反斜杠\，路径结尾是正斜杠/） - 不要写成
"App": "app"（单反斜杠在 JSON 里会转义失败）或"App": "app/"（Windows 风格反斜杠） - 如果类放在
extend/或src/这类非标准目录，必须显式加进psr-4映射，不能指望框架自动扫描 - 改完
composer.json后，必须运行composer dump-autoload -o，光清缓存或重启 PHP-FPM 没用
别让 PHP 版本错位偷偷破坏 autoload 映射
VSCode 终端里报 Class not found，但系统终端能跑通，90% 是因为两个环境调用的 PHP 版本不同，导致 autoload_psr4.php 是用低版本 PHP 生成的，高版本运行时无法解析。
- 在 VSCode 终端执行
which php和php --version，再在系统终端同样执行，比对输出 - 若不一致，不要靠环境变量硬塞 PATH；macOS/Linux 改 VSCode 的默认 shell 配置，Windows 切换终端类型为 Command Prompt
- 验证无误后，删掉
vendor/和composer.lock，用目标 PHP 版本重新执行composer install - 打开
vendor/composer/autoload_psr4.php，搜索你的命名空间前缀，确认映射路径存在且指向真实目录（realpath()能解析成功）
最易被忽略的一点：vendor/autoload.php 必须且只能在入口文件（如 public/index.php）中引入一次。中间件、命令类、测试文件里再 require 它，轻则类重复定义报错，重则 autoload 映射被覆盖失效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
