VSCode调试Laravel时Xdebug报错：Class "Illuminate\Support\Facades\Route"未找到

使用Xdebug的「Launch currently open script」功能调试时抛出该错误的原因主要有三类：

Error: Class "Illuminate\Support\Facades\Route" not found

• 核心触发原因：Launch currently open script的底层逻辑是直接用PHP CLI执行当前打开的单个脚本文件，不会加载Laravel框架的启动引导流程。Laravel的Route属于门面类，必须在框架完成composer自动加载引入、服务容器初始化、门面别名注册这一系列启动步骤后才能正常调用。如果直接打开路由定义文件（比如routes/web.php、routes/api.php）就启动调试，脚本没有走Laravel的public/index.php或者artisan命令的启动逻辑，自然找不到对应类。
• 调试配置错误：如果要调试完整项目，VSCode的Xdebug配置文件launch.json中program参数错误指向了当前打开文件，而非Laravel的项目入口文件，也会触发该报错。
• 自动加载文件损坏：小概率场景下，项目的composer自动加载文件损坏也会导致类找不到，执行composer dump-autoload重新生成自动加载文件即可修复。

内容的提问来源于stack exchange，提问作者codejay