sublime text 不运行 php,而是调用系统 php 命令行程序;必须先确保终端中 php -v 可正常输出版本号,否则所有配置静默失败,装完需重启 sublime text,再配置 php.sublime-build 构建系统并设置 selector 和 -f 参数。

Sublime Text 本身不运行 PHP,它只是调用你系统里已装好的 php 命令行程序——如果终端里 php -v 都报错,所有配置都会静默失败。
确认 php 命令在终端可用是硬门槛
这不是可跳过的步骤,而是整个流程的开关。打开终端(macOS/Linux)或 PowerShell(Windows),执行:
php -v
必须看到类似 PHP 8.2.12 的输出。否则:
- macOS Homebrew 用户:运行
which php,常见路径是/opt/homebrew/bin/php(Apple Silicon)或/usr/local/bin/php(Intel);若无输出,先brew install php - Windows XAMPP 用户:路径通常是
C: mppphpphp.exe,但环境变量要加C: mppphp(不带.exe),然后在 PowerShell 中运行Get-Command php验证 - Linux(apt)用户:确保安装的是
php-cli包,不是仅php,执行sudo apt install php-cli - 装完必须重启 Sublime Text——GUI 启动的 Sublime 不继承 shell 的 PATH,尤其在 macOS M1/M2 或 Windows WSL 下
PHP.sublime-build 构建系统怎么写才不白配
Build System 是让 Ctrl+B(Windows/Linux)或 Cmd+B(macOS)真正跑起来的核心。菜单栏 → Tools → Build System → New Build System…,粘贴以下内容并保存为 PHP.sublime-build:
{
"cmd": ["php", "-f", "$file"],
"selector": "source.php",
"working_dir": "$file_path"
}
关键点:
-
-f参数不能省:它强制指定脚本文件,避免某些 PHP 版本把$file当作参数传给脚本导致卡住 -
"selector": "source.php"必须保留:否则快捷键对非 PHP 文件也响应,或完全不触发 - 文件必须已保存:
$file是当前保存路径,未保存时会报Could not open input file - Windows 路径含空格(如
C:Program Filesphpphp.exe)必须用双引号包裹,且反斜杠要转义:"C:\Program Files\php\php.exe" - 如果
php不在 PATH,就写绝对路径:"cmd": ["C:/xampp/php/php.exe", "-f", "$file"](正斜杠在 Windows 上完全可用)
让 .phtml、.inc 等后缀也能高亮和构建
Sublime 默认只认 .php,其他扩展名打开就是 Plain Text,连 <?php 都不着色。临时解决:打开文件 → 右下角点击语法名(如 “Plain Text”)→ 选 “PHP”。永久绑定:
菜单栏 → Preferences → Settings – Syntax Specific → 在右侧 JSON 中添加:
{"extensions": ["phtml", "inc", "module"]}
注意:不是 Settings – User,语法关联必须走 Settings – Syntax Specific,否则无效。
中文乱码、Parse error、输出为空?别怪 Sublime
这些问题几乎都来自 CLI 层编码错位或使用场景混淆:
- Windows 控制台默认 GBK,而 Sublime 输出 UTF-8:可在构建系统里加
"encoding": "cp936",或改用 PowerShell 启动 Sublime(更可靠) - 文件含中文路径或内容却报
Parse error:XAMPP 自带 PHP 默认用 cp1252 解析,Homebrew 安装的 PHP 更友好;统一用 UTF-8(无 BOM)保存文件(右下角点编码名 → 选 UTF-8 → 保存) - 按 Ctrl+B 能出结果,但浏览器访问
.php显示源码或 404:这是混淆了 CLI 执行和 Web 服务——php -f只跑脚本,不启动服务器;要模拟 Web 环境,得用php -S localhost:8000单独起服务
最常被忽略的点:Sublime 启动方式影响 PATH 继承,尤其是 macOS 和 Windows GUI 启动时;调试复杂逻辑或需要 $_GET/$_POST 的场景,该交给 VS Code 或 PhpStorm。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











