VSC怎样在Linux运行PHP_Ubuntu系统配置步骤【操作】

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 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，写

• 按 Ctrl+` 打开终端，确保当前路径是该文件所在目录（pwd 看）
• 执行 php test.php —— 输出即表示成功；若报 Parse error，检查是否漏了 开头或短标签 被禁用（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 本身没装好或路径不对。