Sublime Text 4 内置 PHP 语法高亮，无需插件即可识别 .php 文件；所谓“装插件”实为按需增强补全、检查、格式化三类能力，且必须确保文件被正确识别为 PHP 语言（右下角显示 PHP），否则后续功能全部失效。
Sublime Text 本身不“安装 PHP 插件”就能让 PHP 文件正常工作——PHP 语法高亮在 ST4 中已内置，只要文件后缀是 .php 或手动设为 PHP 语言即可；所谓“装插件”，实际是按需补足三类能力：代码补全、语法检查（lint）、格式化。装错或贪多反而导致冲突、卡顿、命令失效。
确认 PHP 文件已正确识别为 PHP 语言
这是所有后续功能的前提。很多用户以为没高亮是“没装插件”，其实是 Sublime 没把文件当 PHP 处理：
- 新建文件 → 保存为
test.php（扩展名必须是.php） - 若已打开文件但右下角显示
Plain Text或其他语言，点击该区域 → 选择PHP - ST4 用户无需额外装
PHP语言包；若选不到PHP选项，说明语言定义损坏，可通过Package Control: Install Package→ 搜PHP重装（极少发生）
装 SublimeLinter-php 前先确保 php 命令可用
这个插件不是独立运行的，它调用你系统里的 php CLI 执行 php -l 检查语法。装了插件但报 Could not locate php，90% 是路径问题：
- 终端执行
php -v必须返回版本号，否则先装 PHP 并加进PATH - Windows 用户避免路径含中文、空格或括号，推荐把
php.exe放到C:php，再把该路径加入系统环境变量 - macOS 使用 Homebrew 安装的，
which php返回的路径（如/opt/homebrew/bin/php）要填进插件设置里：Preferences → Package Settings → SublimeLinter → Settings→ 在user配置中加：{"paths": {"linux": [], "osx": ["/opt/homebrew/bin"], "windows": ["C:\php"]}}
补全和跳转必须配 LSP + intelephense，不能只靠 PHP Companion
PHP Companion 只提供模板生成（如 __construct、use 补全），不支持函数跳转、参数提示、类型推导。真要这些能力，必须走 LSP 路线：
立即学习“PHP免费学习笔记（深入）”；
- 先装
LSP插件（搜LSP，别搜Language Server Protocol） - 再装
LSP-intelephense（比LSP-phpactor更省心，对 Composer 项目开箱即用） - 首次启动时状态栏卡在
Starting intelephense？说明二进制下载失败。去Preferences → Package Settings → LSP-intelephense → Settings，把"download": true改成false，然后手动下载对应平台的intelephense二进制，填入"binary_path" - 注意：
LSP-intelephense依赖项目根目录有composer.json和vendor/；没 vendor 就只认内置函数，第三方类库不会提示
别手动拖 ZIP 到 Packages 目录，除非你清楚后果
手动安装看似简单，但极易出问题：
- 插件名必须和仓库主目录名一致（比如克隆
sublime-phpcs，文件夹就得叫Phpcs，否则插件不加载） - ST4 的 API 和 ST3 不兼容，从 GitHub 下的旧版 ZIP 很可能根本不动
- 更新全靠自己盯 release、删旧文件、拖新 ZIP——没人会提醒你有安全补丁
- 真正需要手动装的场景只有两个：公司内网无法联网；或你正在调试某个插件的本地修改版
日常使用请严格走 Package Control: Install Package 流程，搜关键词（如 phpcs、lsp、phpfmt）比输全名靠谱得多。最常被忽略的一点：插件之间会抢 Ctrl+Shift+P 命令或快捷键，比如 PHP Companion 和 LSP-intelephense 都绑定 ctrl+space，冲突时得手动关掉一个的 keymap。
