VS Code 无内置 PHP 服务器，需用 PHP 内置服务器（php -S）启动；确保 php -v 可用，在项目根目录执行 php -S localhost:8000，支持 router.php 自定义路由。
VS Code 本身不带 PHP 本地服务器，必须借助外部工具或插件启动服务；直接双击打开 .php 文件只会看到源码或报错，无法执行 PHP 逻辑。
用 PHP 内置服务器快速启动（推荐初学者）
PHP 5.4+ 自带 php -S 命令，无需安装 Apache/Nginx，适合开发单页或简单项目。
- 确保终端中运行
php -v能正确输出版本（如PHP 8.2.12），否则先配置系统 PATH - 在项目根目录（含
index.php）打开终端，执行：php -S localhost:8000
- 默认会查找当前目录下的
router.php；若无此文件，仅支持直接请求已存在的 PHP 文件（如http://localhost:8000/index.php） - 如需美化路由（例如访问
/about映射到about.php），创建router.php：<?php if (preg_match('/\.(?:png|jpg|jpeg|gif|css|js)$/', $_SERVER["REQUEST_URI"])) { return false; } $filename = __DIR__ . $_SERVER["REQUEST_URI"]; if (is_file($filename)) { return false; } include __DIR__ . '/index.php';
VS Code 中一键启动 PHP 服务器（用插件）
手动敲命令容易忘端口、路径，用 PHP Server 插件可点一下就跑起来。
- 在 VS Code 扩展市场搜索并安装
PHP Server（作者：bradymholt） - 右键任意
.php文件 → 选择PHP Server: Serve project - 插件默认监听
localhost:8080，但会自动检测并避开被占用的端口 - 注意：它只对当前打开的文件所在文件夹生效；如果项目有子目录结构，确保右键的是根目录下的入口文件（如
index.php） - 启动后底部状态栏会出现
PHP Server: http://127.0.0.1:8080，点击即可在浏览器打开
常见打不开 / 报错原因
不是代码写错了，而是环境或路径没对上 —— 这类问题占本地运行失败的 80% 以上。
立即学习“PHP免费学习笔记（深入）”；
-
Command 'php' not found：系统找不到 PHP 可执行文件。Windows 用户检查是否勾选了安装时的 “Add PHP to PATH”；macOS 用户常用brew install php，但新版本可能装成php@8.2，需用brew link php@8.2 - 浏览器显示空白或源码：说明服务器根本没运行，或你访问的是
file:///协议（比如直接拖文件进浏览器）。必须通过http://localhost:xxx -
Unable to open file或Failed to open stream：PHP 内置服务器默认工作目录是命令执行位置，不是 VS Code 当前打开的文件夹。务必cd到项目根目录再运行php -S - 修改代码后刷新没变化：PHP 内置服务器不自动热重载，改完保存后需手动刷新浏览器；如需实时响应，得换用
php -S+entr（Linux/macOS）或第三方工具如Live Server（但该插件不支持 PHP 解析）
真正卡住人的往往不是语法，而是“不知道该让谁来执行这行 PHP”。内置服务器够用就别急着装 XAMPP；插件能省事就别反复 cd 和敲命令。端口冲突、PATH 没配好、误用 file:// 协议——这几个点反复确认一遍，90% 的“打不开”就解决了。
