Sublime Text 无法直接运行 PHP，需系统已安装 CLI 版 PHP 并配置 PATH；通过构建系统调用 php -f "$file" 执行，浏览器预览须启动 PHP 内置服务器或本地 Web 服务，调试依赖 var_dump 等手动方式。
怎么让 Sublime Text 真正执行 PHP 文件
Sublime Text 本身不运行代码，它只是编辑器；所谓“运行 PHP”，本质是调用系统已安装的 php 命令行可执行文件。如果点 Ctrl+B（Windows/Linux）或 Cmd+B（macOS）没反应、报错或输出乱码，大概率不是 Sublime 配置问题，而是 php 没进系统 PATH，或根本没装 CLI 版本。
- 先在终端里运行
php -v，能输出版本号才算基础就位；否则装 PHP 时勾选 “Add to PATH” 或手动配环境变量 - Windows 用户特别注意：官网下载的 Windows ZIP 包默认不带 CLI，得下 Thread Safe + VCx 版本，并确保
php.exe所在目录进了 PATH - macOS 用 Homebrew 装的通常没问题；但用 MacPorts 或自编译的，可能路径是
/opt/local/bin/php或/usr/local/bin/php，需要在 Sublime 的构建系统里显式指定
构建系统（Build System）怎么写才不报错
Sublime 运行 PHP 依赖构建系统（.sublime-build 文件），不能直接双击执行 .php 文件。常见错误是复制网上过时模板，比如硬编码 "cmd": ["php", "-f", "$file"] 却没处理路径空格、中文路径、或缺少 shell 选项导致 Windows 下找不到 php。
- 推荐用以下最小可行配置（保存为
PHP.sublime-build，放在Packages/User/目录）：
{
"cmd": ["php", "-f", "$file"],
"selector": "source.php",
"path": "/usr/local/bin", // macOS/Linux；Windows 可删掉这行或改成 "C:\php"
"file_regex": "php$"
}
path 字段只在必要时加：当 php 不在默认 PATH 里才需指定；误加反而可能覆盖系统 PATH 导致其他命令失效echo 输出中文，Windows 控制台默认 GBK 编码，会乱码；此时建议改用 cmd /c php -f "$file" 并加 "shell": true，让 cmd 自动处理编码为什么浏览器预览总是 404 或显示源码
按 Ctrl+B 是命令行执行，和浏览器访问完全无关。想在浏览器里看 PHP 效果，必须启动一个 HTTP 服务——Sublime 本身不提供 Web Server 功能，也不能靠“打开 HTML”方式加载 PHP 文件。
- 最简方案：用 PHP 内置服务器，在项目根目录终端运行
php -S localhost:8000，然后浏览器访问http://localhost:8000/index.php - 别试图用
file://协议打开 .php 文件——浏览器不会解析 PHP，只会下载或显示源码 - 如果用了 XAMPP/MAMP/WAMP，确认 Apache/Nginx 已启动，且 PHP 文件放在对应
htdocs目录下，再通过http://localhost/xxx.php访问 - Sublime 插件如 “SideBarEnhancements” 提供 “Open in Browser” 功能，但它只对静态文件有效；对 PHP 文件，它只是打开
file://链接，注定失败
调试 PHP 时别指望 Sublime 自带断点功能
Sublime 没有内置 PHP 调试器，Xdebug、PHPStorm 那套远程调试协议它不支持。所谓“调试”，只能靠 var_dump()、error_log() 或日志文件肉眼排查。
立即学习“PHP免费学习笔记（深入）”；
- 如果非要图形化调试，得搭配外部工具：比如 VS Code 装 PHP Debug 插件 + Xdebug，Sublime 只负责写代码
- 有人用 Sublime 的
phpcs或phpcbf做语法检查，这需要单独装 PHP_CodeSniffer，并在构建系统里调用；但这是 lint，不是 debug - 注意
display_errors = On和error_reporting = E_ALL必须在 php.ini 里设好，否则Ctrl+B执行时错误静默消失，你会以为代码没问题
真正卡住的地方往往不是 Sublime 设置，而是 PHP CLI 是否可用、路径是否干净、HTTP 服务是否独立启动——这三个点理不清，所有插件和配置都是白搭。
