VS Code 需系统已安装 PHP CLI 并配置 PATH 才能运行 PHP；终端执行 php -v 验证，Windows 用户需手动添加 XAMPP/WAMP 的 PHP 路径到环境变量；推荐插件为 PHP Intelephense 和 PHP Debug；可用 php -S 启动内置服务器。
VS Code 本身不内置 PHP 运行环境，也不能直接启动 PHP 内置服务器——必须依赖系统已安装的 PHP CLI 可执行文件，且路径需被正确识别。没装 PHP 或 php 命令不可用，所有配置都无效。
确认本地已安装 PHP 并可命令行调用
这是最常卡住的一步：VS Code 不会帮你装 PHP，它只调用你系统 PATH 里的 php。
- 终端中运行
php -v，必须输出版本号（如PHP 8.2.12），否则先去官网下载安装包或用brew install php（macOS）/scoop install php（Windows）补上 - Windows 用户特别注意：如果用 XAMPP/WAMP，要手动把类似
C:\xampp\php的路径加进系统环境变量PATH，否则 VS Code 终端和插件都找不到php - VS Code 内置终端重启后才读取新 PATH，改完记得关掉再开一个终端验证
php -v
安装必要插件：PHP Intelephense + PHP Debug
官方 PHP 扩展包（php-vscode）早已弃用，现在标准组合是：
-
PHP Intelephense：提供代码补全、跳转、诊断（比原生语言支持强得多） -
PHP Debug（by Felix Becker）：对接 Xdebug，断点调试必备 - 可选：
PHP DocBlocker快速生成注释，PHP CS Fixer格式化代码
装完插件后，打开一个 .php 文件，看右下角是否显示 PHP 版本号——不显示说明插件没生效或 PHP 路径未识别。
立即学习“PHP免费学习笔记（深入）”；
用 PHP 内置服务器快速启动本地服务
不需要 Apache/Nginx，PHP 自带的 php -S 就够开发用，但要注意工作目录和路由文件。
- 在项目根目录打开 VS Code 终端，运行：
php -S localhost:8000 -t public/（假设入口文件在public/index.php） - 若需支持 URL 重写（如 Laravel 的
index.php路由），加路由文件：php -S localhost:8000 router.php -t public/，其中router.php至少包含否则 404 - VS Code 中按
Ctrl+Click（Windows/Linux）或Cmd+Click（macOS）无法跳转到函数定义？检查Intelephense设置里intelephense.environment.includePaths是否包含你的 vendor 或框架路径
调试时 Xdebug 配置最容易出错
PHP Debug 插件只是“客户端”，真正要连上的是你本地 PHP 的 Xdebug 扩展——它默认不启用，也不监听 VS Code。
- 运行
php --ini找到Loaded Configuration File，编辑该php.ini - 确认有
zend_extension=xdebug（Linux/macOS 路径类似xdebug.so，Windows 是php_xdebug.dll） - PHP 8.0+ 推荐配 Xdebug 3：
zend_extension=xdebug
xdebug.mode=debug
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.start_with_request=yes - VS Code 中创建
.vscode/launch.json，选 “Listen for Xdebug” 模板，并确保port和xdebug.client_port一致（默认都是 9003）
断点不命中？八成是 xdebug.mode 没设对，或 xdebug.start_with_request 关了又没手动加 XDEBUG_SESSION_START=1 参数访问 URL。
