sublime text 本身不带 php 解释器，所有运行能力均依赖系统已安装且 path 可调用的 php 命令；必须先在终端执行 php -v 成功返回版本号，否则后续构建系统、插件等配置均无效。
Sublime Text 本身不带 PHP 解释器，所有“运行 PHP”的能力都依赖你系统里已安装且可调用的 php 命令——如果 php -v 在终端报错，后续任何配置都无效。
确认 php 命令在终端可用是唯一前提
这不是 Sublime 的问题，是环境没配对。打开终端（macOS/Linux）或 CMD/PowerShell（Windows），执行：
php -v
必须返回类似 PHP 8.2.12 的版本号。否则别往下走。
- Windows 用户常见问题：XAMPP 安装后没把
C:/xampp/php加进系统PATH；验证方法是 CMD 里运行where php - macOS 用户常见问题：从 Dock 或 Spotlight 启动 Sublime，它读不到 shell 配置里的
PATH；解决办法是终端里执行subl .启动编辑器 - Linux 用户注意：装的是
php-cli包，不是只装了php（某些发行版默认不装 CLI） - 安装后必须重启 Sublime，否则它不会加载更新后的环境变量
PHP.sublime-build 构建系统怎么写才不静默失败
Sublime 不运行 PHP，它只是调用你系统的 php 命令。构建系统就是告诉它“怎么调”。最简可靠配置如下：
{
"cmd": ["php", "-f", "$file"],
"selector": "source.php",
"working_dir": "$file_path"
}
-
-f参数必不可少：避免php $file被某些 PHP 版本误解析为传参，导致卡住或报错 -
"selector": "source.php"必须写：否则 Ctrl+B 对非 PHP 文件也生效，或根本触发不了 - 文件未保存时会报
Could not open input file：因为$file变量为空，务必先Ctrl+S - Windows 下路径含空格（如
C:Program Filesphpphp.exe）必须用双引号包裹整个路径，但 JSON 里要用反斜杠转义："C:\Program Files\php\php.exe" - 如果
php不在PATH中，就写绝对路径："cmd": ["C:/xampp/php/php.exe", "-f", "$file"]（正斜杠在 Windows 上完全可用）
中文输出乱码、Parse error、浏览器 404 怎么办
这些都不是构建系统本身的问题，而是执行上下文或使用场景错位：
- Windows 控制台默认 GBK 编码，而 Sublime 输出 UTF-8：在构建系统里加
"encoding": "cp936"，或改用 PowerShell 启动 Sublime（更推荐） - 文件含中文路径或内容却报
Parse error：XAMPP 默认用cp1252解析，加"encoding": "cp936"或改用 Homebrew 安装的 PHP（默认 UTF-8 友好） - 按 Ctrl+B 能出结果，但浏览器访问 .php 文件显示源码或 404：这是混淆了 CLI 执行和 HTTP 服务——Sublime 没有 Web Server。想浏览器预览，得手动启动 PHP 内置服务器：
php -S localhost:8000 -t ./ - 构建成功但 PHP 报
Fatal error: Cannot redeclare function：检查php.ini中是否启用了opcache.enable_cli=1，CLI 模式下开启 opcache 会导致函数定义被缓存
语法检查、格式化、跳转靠插件，但得显式指定 php 路径
SublimeLinter-php、PHP-CS-Fixer、PHP Companion 这些插件不会自动找 php，尤其 GUI 启动的 Sublime 通常读不到 shell 的 PATH。
- SublimeLinter-php：在
Preferences → Package Settings → SublimeLinter → Settings（右侧面板）中填：
{"paths": {"osx": ["/opt/homebrew/bin"], "windows": ["C:/xampp/php"], "linux": ["/usr/bin"]}}
- 注意：
paths填的是目录，不是php可执行文件本身；多个路径用数组，不要漏掉逗号 - PHP-CS-Fixer 如果报
command not found：先终端确认php-cs-fixer是否可用；不可用就用 Composer 全局安装：composer global require friendsofphp/php-cs-fixer，再把~/.composer/vendor/bin加进PATH - PHP Companion 的类跳转失效：多半是因为项目没设为 Sublime Project（
Project → Save Project As…），它依赖项目根目录识别命名空间
真正容易被忽略的点是：所有插件的路径配置都只认目录，不是可执行文件；而构建系统里写的是可执行文件。这两者不能混用，也不能互相替代。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
