PHP空白页主因是错误被静默忽略，需开启display_errors、display_startup_errors并设error_reporting(E_ALL)；若仍空白则查服务器错误日志；还可能是Web服务器未解析PHP而直接返回源码。
PHP文件打开后全是白色，连<?php 都不高亮
不是插件没装，是Sublime根本没把当前文件当PHP处理。默认只认.php后缀，遇到index、config.inc、module或.phtml就直接 fallback 成Plain Text。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 打开文件后，看右下角显示的语法名（比如“Plain Text”），点它 → 选
PHP - 想一劳永逸：点菜单 View → Syntax → Open all with current extension as… → PHP（注意不是HTML或Text）
- 若常用
.inc、.module等扩展名，进 Preferences → Settings – Syntax Specific，在右侧加：{"extensions": ["inc", "module", "phtml", "install"]}，保存即生效 - 别误改
Settings – User，语法映射必须走Settings – Syntax Specific，否则无效
保存PHP文件后没红波浪线，SublimeLinter不报错
90%的情况是插件压根没调起php命令——不是配置错，是根本没找到可执行文件。Sublime GUI启动时不继承终端PATH，which php在终端有效 ≠ Sublime能调用。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先在终端运行
php -v，失败就停步，先装PHP并配好系统环境变量 - macOS用Homebrew：运行
which php，常见路径是/opt/homebrew/bin/php（M1/M2）或/usr/local/bin/php（Intel） - Windows用户填完整路径，如
C:/xampp/php/php.exe或C:/wamp64/bin/php/php8.2.12/php.exe，斜杠用/或双反斜杠\，别用单反斜杠 - 进 Preferences → Package Settings → SublimeLinter → Settings，右侧用户设置中加：
{"linters": {"php": {"executable": "/opt/homebrew/bin/php", "lint_mode": "save"}}} -
lint_mode必须设为"save"：PHP的php -l不加载运行时环境，"background"模式会频繁误报undefined constant，且卡输入
装了SublimeLinter-php但控制台报php: command not found
这是典型路径配置失效信号。插件找不到php可执行文件，就会静默失败，不报错也不标红，你只能去控制台（Ctrl+`）里搜这行字才能发现。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确认已同时安装
SublimeLinter和SublimeLinter-php两个插件——只装一个等于没装 - 检查
executable值是不是绝对路径，且指向php可执行文件本身（如/usr/bin/php），不是目录（如/usr/bin），也不是字符串"php" - 如果项目用PHP 8.2语法（比如
match表达式），但executable指向PHP 7.4，php -l会直接报语法错误，这不是代码问题，是版本不匹配 - macOS用户尤其注意：GUI应用不读
~/.zshrc，哪怕你在终端里echo $PATH能看到brew路径，Sublime也看不到
为什么php -l检查总报undefined constant却不是真错误
因为php -l只是词法+语法扫描，不执行代码，不加载$_SERVER、不定义常量、不包含config.php。它看到DB_HOST就报错，但实际运行完全正常。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 这类警告可忽略，
php -l本就不适合带全局依赖的文件；真要严格检查，得换phpstan或psalm，但那是另一套配置 - 如果非要消除干扰，把常量定义抽到单独文件，用
require_once引入，php -l对空文件不报错 - 别试图在
SublimeLinter里加-d参数模拟环境——它不支持，强行加会导致整个linter挂掉
php命令路径，而运行还得另配构建系统——每层都可能断在不同地方。 
