Intelephense启动失败“PHP executable not found”需手动配置intelephense.phpExecutablePath为系统真实PHP路径，并在Sublime控制台验证PATH是否包含该路径；PHP 8类型提示需在项目配置中显式添加vendor/autoload.php等includePaths并正确使用@var注解。
Intelephense 启动失败：PHP executable not found 怎么办
这不是插件没装好，而是 Sublime 根本找不到你的 php 命令。Intelephense 不自带解释器，它必须调用系统已安装的 CLI 版 PHP —— 终端里能跑 php -v，不代表 Sublime 能读到。
- 在 Sublime 控制台（
Ctrl+`）执行import os; os.environ.get('PATH')，检查输出里有没有你 PHP 的路径（比如/opt/homebrew/bin或C:/php） - macOS M1/M2 用户慎用
/usr/bin/php（系统弃用），改用 Homebrew 安装的版本，填完整路径如/opt/homebrew/bin/php - Windows 用户路径中避免空格和中文，推荐用正斜杠：
C:/php/php.exe，别写成C:\php\php.exe（反斜杠在 JSON 里要转义） - 确认后，在
Preferences → Package Settings → Intelephense → Settings的用户设置里加："intelephense.phpExecutablePath": "/your/real/php/path"
PHP 8 类型提示不生效：vendor 索引和 @var 注解怎么配
Intelephense 对 PHP 8 的联合类型、属性类型、构造器属性提升等支持良好，但前提是它得“看见”你的依赖和类型声明。默认只索引当前文件，vendor 目录和注解不会自动识别。
- 必须在项目根目录的
.sublime-project文件里显式启用 vendor 自动扫描："settings": { "intelephense.environment.includePaths": ["./vendor/autoload.php"] } -
@var注解只在变量未声明类型时起作用，且需写在变量赋值前一行，例如：/** @var \DateTime $now */ $now = new \DateTime(); - 如果用了 Laravel 或 Symfony，建议额外加入框架引导文件路径，比如
bootstrap/app.php，帮助解析服务容器绑定 - 索引完成后，右下角状态栏会显示
LSP-Intelephense: ready；若长时间卡在indexing...，检查vendor是否真存在，或临时删掉node_modules避免干扰
补全响应慢或卡顿：LSP 设置与项目规模怎么平衡
Intelephense 在大项目里容易 CPU 占满、补全延迟高，不是它不行，是默认配置在“全量分析”——尤其当项目混着 node_modules、dist 这类目录时。
- 在
LSP.sublime-settings（用户侧）中限制索引范围："lsp_servers": { "intelephense": { "settings": { "intelephense.files.exclude": ["**/node_modules/**", "**/dist/**", "**/build/**"] } } } - 关闭非必要功能节省资源：
"intelephense.stubs": []（禁用内置 stubs，靠 composer autoload 更准） - 补全触发延迟调低：
"auto_complete_delay": 0（单位毫秒，设为 0 表示按键即弹出） - 确保
"auto_complete_commit_on_tab": true已开启，否则按Tab只插入空格，不确认补全项
Ctrl+Space 没反应：语法模式和 LSP 激活状态怎么查
很多人以为装了插件就万事大吉，结果敲 DateTime:: 后按 Ctrl+Space 什么也不出来——大概率是 LSP 没真正接管当前文件，或者语法识别错了。
立即学习“PHP免费学习笔记（深入）”；
- 看右下角状态栏：必须显示
LSP-Intelephense，而不是Plain Text或PHP（纯语法高亮）。如果不是，执行Ctrl+Shift+P → LSP: Enable Language Server Globally，再选intelephense - 按
Ctrl+Shift+P → Developer: Show Scope Name，确认当前 scope 是source.php，不是text.html.php或其他变体；如果是，需在Settings里修正"selector": "source.php" - 补全框不弹，先检查用户设置里是否漏了：
"auto_complete": true—— 这个开关控制“弹不弹”，和智能程度无关，但它是前提 - PHP 文件扩展名若为
.phtml，需在LSP.sublime-settings中把"selector"改成"source.php, source.php.embedded-html"
Intelephense 对 PHP 8 的支持本身很扎实，但它的行为高度依赖路径、索引范围和 LSP 激活时机。最容易被忽略的是：Sublime 的环境变量和终端不共享，以及 vendor 目录必须显式纳入 includePaths —— 这两点不处理，哪怕 PHP 8.3 装得再新，提示也只会停留在函数名层面。
