VSCode怎么搭建PHP Laravel环境_VSCode高效开发Web应用【实操】-VSCode-PHP中文网

vscode对laravel支持需三者协同：正确php路径、启用并完成索引的intelephense、完整项目结构（composer install完成且vendor存在），缺一即导致路由跳转失败、参数无提示、blade变量标红等连锁问题。

vscode怎么搭建php laravel环境_vscode高效开发web应用【实操】

VSCode 对 Laravel 的支持不是开箱即用的，必须手动配齐三样东西：正确的 PHP 可执行路径、启用且索引完成的 PHP Intelephense、以及项目结构就位（composer install 完成、vendor/ 存在）。缺一不可，否则 Ctrl+Click 跳不进 Route::get()、$request->validate() 没参数提示、Blade 里 $user->name 标红，全是连锁反应。

为什么 `PHP Intelephense` 必须启用并重建索引

它不是“装了就灵”的插件，而是靠静态扫描构建符号表。首次打开 Laravel 项目时，右下角状态栏会显示 “Indexing…”，这个过程可能耗时几十秒到几分钟（取决于 vendor 大小）。没等它完成就点跳转，大概率失败。

右键点击状态栏的 Intelephense 图标 → 选 “Rebuild index”，尤其在改过 composer.json 或新增了包之后
确保 Intelephense › Enabled 在设置里是 true；只点“Enable”不行，必须点“Enable for Workspace”
如果模型属性（如 User::$fillable）没提示，先运行 php artisan ide-helper:models --nowrite 生成注释，再触发重载索引

`php.validate.executablePath` 填错会导致全链路失效

VSCode GUI 进程不读 shell 的 ~/.zshrc，所以即使终端里 php -v 正常，VSCode 也可能报 “PHP executable not found”。这不是插件问题，是路径根本没对上。

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

macOS M1/M2：填 /opt/homebrew/bin/php（Homebrew 安装）或 /usr/local/bin/php（MacPorts）
Windows：填完整路径如 C:\php\php.exe 或 C:\xampp\php\php.exe，不能写 php
改完保存后，关掉所有已打开的 PHP 文件再重开，避免语言服务缓存旧路径

路由跳转失效？检查 `intelephense.environment.includePaths`

Intelephense 默认只扫项目根目录，Laravel 核心类在 vendor/laravel/framework/src/Illuminate，不显式告诉它去哪找，就等于“视而不见”。

在项目根目录建 .intelephense.json，内容至少包含：{"includePaths": ["./vendor/laravel/framework/src/Illuminate"]}
如果用了自定义包或 src/ 目录取代 app/，也要加进去，比如 ["./src", "./app", "./vendor/autoload.php"]
字符串控制器写法（'UserController@show'）能跳，但数组写法（[UserController::class, 'show']）更稳——Intelephense 对 ::class 常量识别更准

Blade 模板里变量没提示？别只怪插件

Laravel Blade Snippets 只管语法片段，变量提示靠的是 Intelephense 推断上下文。它不会主动解析 with(['user' => $user]) 或控制器里的 compact('user')，除非你写了明确的 PHPDoc。

在 Blade 文件顶部加注释：/** @var \App\Models\User $user */，Intelephense 就能识别 $user->name
用 @props(['user'])（组件属性）比 with() 更易被推断
确认 Intelephense 已扫描到 app/Http/Controllers/ 和模型文件，否则连 \App\Models\User 都不认识

最常被忽略的一点：Intelephense 索引是“静态”的，它不运行代码，也不理解运行时绑定（比如 Service Container 动态解析的实例）。所以 app(UserRepository::class) 返回的对象属性，不会自动有提示——得靠 PHPDoc 补全。这不像 Laravel Idea 那样有运行时分析能力，但换来的是零配置、零性能开销。