PHP Intelephense需正确配置PHP路径、语言版本并禁用VS Code内置PHP支持，否则提示失效；须认准Ben Mewburn发布版，Windows路径反斜杠需双写，修改配置后必须重启VS Code窗口。
PHP Intelephense 不是“装上就灵”的插件——它依赖准确的 PHP 环境路径、合理的语言级别设定，以及对默认内置 PHP 支持的主动禁用。装错或漏配，你只会看到提示卡顿、跳转失效、__construct 不提示、foreach 变量类型推断全丢。
怎么装？别搜“PHP IntelliSense”
VS Code 市场里叫 PHP IntelliSense 的是已停更的老插件（作者弃坑多年），现在真正维护、支持 PHP 8.3+、LSP 协议、类型推断强的，只有 PHP Intelephense（作者：Ben Mewburn）。搜错名字，装了也白装。
- 打开 VS Code → 左侧扩展图标（或
Ctrl+Shift+X） - 搜索框输入
PHP Intelephense→ 认准发布者是Ben Mewburn→ 点击 Install - 装完后，**立刻禁用 VS Code 自带的
PHP Language Features**：
按Ctrl+Shift+P→ 输入@builtin php→ 找到PHP Language Features→ 点击右下角齿轮图标 → Disable (Workspace)
为什么装完没提示？90% 是路径或语言级别错了
Intelephense 需要知道你的项目用的是 PHP 7.4、8.1 还是 8.3，否则连 match 表达式都识别不了；它还要能调用 php.exe 做静态分析，路径不对，直接哑火。
- 确认 PHP 已安装且可执行：
终端运行php -v，有输出才算真装好（不是靠 XAMPP/WAMP 图形界面“启动成功”就以为 OK） - 在 VS Code 中按
Ctrl+,→ 搜索intelephense.environment.phpVersion→ 设为和你项目一致的版本，例如"8.2" - 搜索
intelephense.executablePath→ 填入绝对路径，如：C:\php\php.exe（Windows）或/usr/local/bin/php（macOS） - 如果用的是 XAMPP，路径通常是：
C:\xampp\php\php.exe（别填C:\xampp\php少了\php.exe）
提示不全、跳转失败？检查工作区设置和文件关联
全局设置管不住单个项目——比如你有个 Laravel 项目用了 .phpstorm.meta.php 或自定义 Facade，就得靠工作区配置告诉 Intelephense：“这些文件也要当 PHP 解析”。
- 在项目根目录建
.vscode/settings.json（若无） - 加入以下最小必要配置：
{
"intelephense.environment.phpVersion": "8.2",
"intelephense.executablePath": "C:\\php\\php.exe",
"files.associations": {
"*.php": "php",
"*.module": "php",
"*.inc": "php"
}
}
-
"*.module"和"*.inc"是 Drupal/WordPress 常见扩展名，不加它们，函数跳转会断 - 路径中反斜杠要双写（
\\），Windows 下单斜杠或不转义会报错 - 改完保存，**必须重启 VS Code 窗口**（不是重载窗口），否则缓存不刷新，提示照旧不灵
调试时提示消失？别让 Xdebug 和 Intelephense 抢资源
装了 PHP Debug 插件后，如果发现 hover 查文档变慢、Ctrl+Click 跳转卡住，大概率是两个插件都在监听同一份 PHP 文件，争抢语言服务器连接。
立即学习“PHP免费学习笔记（深入）”；
- 确保
PHP Debug的launch.json里没启用"pathMappings"映射到错误目录（尤其 Docker 场景） - 在
settings.json加一行："intelephense.trace.server": "messages"→ 打开 Output 面板选Intelephense，看有没有connection refused类报错 - 临时验证法：关掉所有 PHP 相关扩展 → 只留
Intelephense→ 测试提示是否恢复 → 再逐个开回其他插件定位冲突源
Intelephense 的智能程度，一半看它自己，一半看你给它的路径对不对、版本设没设、文件关没关联上。最容易被跳过的，就是禁用默认 PHP 支持、双写 Windows 路径、以及改完 settings.json 后忘记重启整个 VS Code 窗口——这三步漏掉任意一个，你看到的就只是“好像装了，但没啥用”。 
