vs code 本身不运行 php，真正执行的是系统安装的 php 命令；需确保 ubuntu 正确安装 php-cli 等扩展、vs code 安装 php intelephense 或 php server 扩展，并在集成终端中通过 php test.php 运行脚本。
VS Code 本身不运行 PHP，它只是编辑器；真正执行 PHP 脚本的是系统安装的 php 命令。Ubuntu 上能用 VS Code 写 PHP 并顺利运行，关键在三件事：装对版本的 PHP、VS Code 装好必要扩展、终端里能直接调用 php。
确认系统已安装 PHP 并在 PATH 中
很多 Ubuntu 桌面版默认不带 PHP，或者只装了 php-cli（命令行版）但没加进环境变量。先打开终端验证：
php -v
如果报错 Command 'php' not found，说明没装或没配置好 PATH。Ubuntu 22.04+ 推荐用官方仓库安装：
- 运行
sudo apt update && sudo apt install php-cli php-mbstring php-xml php-zip（mbstring和xml是 Laravel、Composer 等常用扩展） - 装完再执行
which php，应输出类似/usr/bin/php；若无输出，检查是否误装了php8.1-cli等带版本号的包，可用sudo apt install php-cli自动选最新稳定版 - 别用 snap 安装的 PHP（路径怪、权限受限），也别手动编译后忘记加
export PATH=/path/to/php:$PATH
VS Code 必装扩展：PHP Intelephense 或 PHP Server
纯编辑器无法跳转函数、提示语法、运行脚本。两个最实用选择：
立即学习“PHP免费学习笔记（深入）”；
-
PHP Intelephense（付费功能有限，免费版够日常）：提供智能补全、错误检测、Ctrl+Click跳转。装完重启 VS Code，打开一个.php文件，状态栏右下角应显示Intelephense -
PHP Server（轻量免费）：右键文件 →PHP Server: Serve project，会在http://127.0.0.1:8080启一个简易 Web 服务，适合调试单文件或小型项目 - 别装过时的
PHP Tools（已停止维护）或只装PHP Debug却不配 Xdebug——没 Web 服务器或调试器，F5运行会失败
在 VS Code 终端里直接运行 PHP 脚本
VS Code 自带集成终端（Ctrl+`），本质就是你系统的 bash/zsh，只要系统 php 可用，这里就能跑：
- 新建文件
test.php，写<?php echo "Hello from VS Code"; ?>
- 按
Ctrl+`打开终端，确保当前路径是该文件所在目录（pwd看） - 执行
php test.php—— 输出即表示成功；若报Parse error，检查是否漏了<?php开头或短标签被禁用（Ubuntu 默认禁用，用完整标签） - 不要依赖「Code Runner」插件一键运行：它默认用
php -S启内置服务器，但-S需要 PHP 5.4+ 且不支持路由重写，容易误导初学者以为“PHP 运行不了”
常见卡点：中文路径/文件名、权限、Apache 冲突
不是所有问题都出在 VS Code 或 PHP 配置上：
- 文件路径含中文？Linux 终端对 UTF-8 支持一般没问题，但某些旧 shell 或 VS Code 终端编码设为
ISO-8859-1会导致php: command not found错误——在 VS Code 设置里搜terminal.integrated.env.linux，加"LANG": "en_US.UTF-8" - 执行
php -S报Could not bind to address？说明端口被占（如 Apache 正在跑），改用php -S 127.0.0.1:8001换端口 - 写完代码 Ctrl+S 没反应？检查文件后缀是不是
.php（不是.txt或没后缀），且 VS Code 右下角语言模式显示为PHP（点一下切换）
真正卡住的时候，先扔掉 VS Code，回到终端用 php -v 和 php yourfile.php 两步验证底层是否通畅——90% 的“VS Code 运行不了 PHP”其实是 PHP 本身没装好或路径不对。
