vs code 仅是编辑器，运行 laravel 需先配置本地 php 环境、composer 和 artisan；调试需正确安装 xdebug 并在 launch.json 中配置路径映射与端口；前端构建应统一使用 vs code 内置终端执行 npm 命令。
VS Code 本身不运行 Laravel，它只是编辑器；真正运行 Laravel 需要本地 PHP 环境 + Composer + Artisan 命令。VSC 的作用是写代码、调试、启动内置服务器（有限）、配合终端执行命令——别指望点一下按钮就跑起 Laravel。
PHP 和 Composer 必须先装好，否则 VSC 打不开 Laravel 项目
很多人卡在这一步：打开 laravel new blog 创建的项目，php artisan serve 报错 “command not found” 或 “PHP is not recognized”。这不是 VSC 的问题，而是系统没配好基础环境。
- Windows 用户确认
php -v和composer -v能在任意终端（CMD/PowerShell/VS Code 内置 Terminal）中正常输出版本号 - macOS 用户若用 Homebrew 安装 PHP，检查
which php返回路径是否在$PATH中（常见坑：/opt/homebrew/bin/php没加入 shell 配置） - Linux 用户注意 Ubuntu/Debian 默认不带
php-cli，需手动sudo apt install php-cli unzip
在 VSC 终端里启动 Laravel 开发服务器最可靠
VSC 内置 Terminal（Ctrl+` 或 View → Terminal）和系统终端行为一致，只要环境变量正确，php artisan serve 就能跑起来。别依赖插件“一键启动”，那些插件本质也是调这个命令。
- 确保你在 Laravel 项目根目录（含
artisan文件的目录），再运行php artisan serve - 默认监听
http://127.0.0.1:8000，可加参数改端口或地址：php artisan serve --port=8080 --host=0.0.0.0 - 如果提示
Unable to load dynamic library 'sodium'，说明 PHP 扩展缺失，不是 VSC 问题，去php.ini解开对应扩展注释或重装 PHP
PHP Debug 插件（PHP Debug by Felix Becker）必须配好才能断点调试
光装插件不行，得让 VS Code 知道你的 PHP 可执行文件在哪，还要启动 Xdebug（Laravel 默认不启用）。不配对，F9 打断点完全没反应。
立即学习“PHP免费学习笔记（深入）”；
- 确认已安装并启用 Xdebug：运行
php -m | grep xdebug，有输出才继续；没有就按官方文档编译或配置php.ini - 在 VSC 中按
Ctrl+Shift+P→ 输入PHP: Select Interpreter→ 选你本地的php可执行文件（如/usr/bin/php或C:\xampp\php\php.exe） - 项目根目录新建
.vscode/launch.json，内容至少包含：{ "version": "0.2.0", "configurations": [ { "name": "Listen for Xdebug", "type": "php", "request": "launch", "port": 9003, "pathMappings": { "/var/www/html": "${workspaceFolder}" } } ] }注意：port要和php.ini中xdebug.client_port一致（Xdebug 3 默认是9003）；pathMappings的左边是你容器/服务器上的路径（本地开发通常就是${workspaceFolder}），右边是本地路径
Laravel Mix / npm 脚本别在 VSC 外部终端跑，统一用 VSC Terminal
执行 npm run dev 或 npm run build 时，如果在外部 CMD 或 iTerm 里运行，VSC 不知道这些进程状态，热更新、错误提示都不同步。而且容易因 Node 版本或 node_modules 权限问题失败。
- 在 VSC Terminal 中执行
npm install（首次）和npm run dev，确保package.json存在且node -v可用 - 如果报错
cross-env: command not found，说明node_modules/.bin没进$PATH—— 别全局装 cross-env，直接npm install重装依赖即可 - 观察 Terminal 输出是否出现
Compiled successfully和webpack compiled successfully，没这句说明前端资源根本没生成，mix()在 Blade 里会报 404
真正麻烦的从来不是 VSC 设置，而是 PHP、Xdebug、Node、Composer 四者版本兼容性。比如 PHP 8.2 + Xdebug 3.1 + Laravel 10 是稳的，但换成 PHP 8.3 beta 就可能触发未适配的警告；又比如 Laravel Sail 用户硬要在 VSC 里配 Xdebug，结果 Docker 网络不通——这些都不是点几下鼠标能解决的。
