Sublime Text默认仅识别.php后缀，.phtml、.module等扩展名需手动关联PHP语法高亮：右下角点击“Plain Text”→“Open all with current extension as”→选择PHP。
PHP语法高亮和文件关联没生效
Sublime Text默认支持.php后缀，但如果你新建一个index文件手动写PHP代码，或用了.phtml.module等扩展名，就会变成纯文本模式——连<?php 都不高亮。
解决方法很简单：打开文件 → 右下角点击当前语法类型（比如 Plain Text）→ 选择 PHP；更彻底的做法是设置自动关联：
- 菜单栏 → Preferences → Settings – Syntax Specific
- 在右侧配置里加：
{"extensions": ["phtml", "module", "inc"]} - 保存后，这些后缀会自动用PHP语法解析
注意：别误改Settings – User，那是全局配置，语法关联必须走Syntax Specific，否则无效。
运行PHP脚本时提示php: command not found
这是路径问题。Sublime Text的Build System默认调用系统PATH里的php命令，但macOS M1/M2、Windows WSL或手动编译PHP的用户，常出现PATH没配好或根本没加进环境变量的情况。
立即学习“PHP免费学习笔记（深入）”；
验证方式：终端里执行which php或where php（Windows），拿到真实路径，比如/opt/homebrew/bin/php或C:phpphp.exe。
- 菜单栏 → Tools → Build System → New Build System
- 替换内容为（以macOS为例）：
{ "cmd": ["/opt/homebrew/bin/php", "-l", "$file"], "selector": "source.php", "file_regex": "php.*?on line (\d+)" } - 保存为
PHP.sublime-build，再在Build System里选它
关键点：cmd里必须写绝对路径；-l是语法检查，换成-f可执行；别漏掉selector，否则快捷键Ctrl+B不触发。
PHP代码补全和跳转不工作
Sublime Text原生不带PHP语义分析，所谓“补全”只是基于已有代码片段的模糊匹配。想实现函数跳转、参数提示、类成员补全，得靠插件，但别装错。
- 推荐用
PHP Companion（需配合php-language-server）或轻量级的SublimeCodeIntel（已停止维护但够用） - 安装后务必检查
php.executable_path是否指向你的PHP二进制文件，否则跳转全部失效 - 如果项目有
composer.json，补全范围取决于vendor/autoload.php能否被正确加载——不是所有插件都支持PSR-4自动发现
常见坑：装了PHPUnit插件却没配phpunit.phar路径，结果右键菜单里“Run Test”点下去没反应，其实只是找不到命令。
调试PHP没法断点、看变量
Sublime Text本身不支持PHP调试协议（DBGp），Xdebug或Zend Debugger的断点、堆栈、变量监视功能，必须通过第三方桥接。目前唯一稳定可用的是Xdebug Client插件，但它对配置极其敏感。
- 先确认PHP.ini里已启用xdebug：必须有
xdebug.mode=debug和xdebug.client_host=127.0.0.1（非localhost） - 插件配置里
port要和xdebug.client_port一致，默认9003，不是旧版的9000 - 浏览器访问时必须带
XDEBUG_SESSION_START=1参数或用官方浏览器插件激活，否则Sublime收不到连接请求
最容易忽略的是防火墙——特别是Windows Defender或macOS Monterey+系统，会静默拦截9003端口的入站连接，导致“监听中”但永远等不来调试会话。
