Intelephense 类型推断失效主因是索引未完成、路径错配或符号不可见导致的“静默降级”，表现为补全减少、跳转失灵、参数提示为 any；需检查 php.executablePath、composer.json 及 vendor/、配置 includePaths、添加 PHPDoc 类型标注、避免变量拼接 include 路径、声明属性类型并手动重载窗口触发重索引。
PHP 类型推断在 VS Code 中失效，**几乎从不因为 Intelephense 插件本身崩溃，而是索引未完成、路径错配或符号不可见导致的“静默降级”**。它不会报错，只是补全变少、跳转失灵、参数提示变成 any——这种“半瘫痪”状态最耗时间。
Intelephense 卡在 “Indexing…” 不动怎么办
这是最典型的假死现象，本质是语言服务器卡在解析阶段，无法建立符号表。
- 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，切换到Console标签页，搜索PHP executable not found或failed to spawn—— 90% 的卡顿源于此 - 检查设置中
php.executablePath是否指向真实可执行文件（Windows 必须带.exe，macOS/Linux 路径如/opt/homebrew/bin/php） - 确认项目根目录存在有效的
composer.json，且已运行过composer install；若vendor/为空，Intelephense 就没有上下文可分析 - 若项目较大（含大量第三方包），可在
.vscode/settings.json中显式限制扫描范围：{ "intelephense.files.exclude": ["**/vendor/**", "**/node_modules/**"] }，避免索引陷入无限递归
自定义函数/全局常量不提示，但类方法正常
Intelephense 默认只索引命名空间类和 vendor/ 下内容，对 helpers/*.php、config/*.php 这类非标准加载文件默认忽略。
- 在项目根目录新建
.intelephense.json，用environment.includePaths显式声明需扫描的目录：{ "environment.includePaths": ["./app/helpers", "./config", "./bootstrap"] } - 为全局函数添加最小 PHPDoc 注释，哪怕只有
/** @return string */—— 没有类型标注，Intelephense 就无法推断返回值，直接跳过补全 - 禁止在
include或require中使用变量拼接路径（如require $dir . '/functions.php'），静态分析器无法追踪变量来源，相关符号不会进入索引
参数提示全是 any 或 mixed
这不是插件问题，是类型信息缺失的直接表现，尤其在 PHP 7.4+ 弱类型环境下更明显。
立即学习“PHP免费学习笔记（深入）”；
- 函数参数必须加类型声明（
function foo(string $name): int）或 PHPDoc（/** @param string $name */），否则 Intelephense 只能标记为mixed - 对象属性若未声明类型（如
public $data;），访问其子属性时也会退化为any；建议启用strict_types=1并补全属性类型（public array $data;） - 避免嵌套过深的泛型工具类型（如
DeepPartial<deeppartial>></deeppartial>），TS/Intelephense 类型系统有递归深度限制（默认约 100 层），超限后直接放弃推断，表现为大面积any
最易被忽略的一点：Intelephense 的索引不是一次性完成的后台任务，它会随文件修改动态增量更新。但如果你改了 composer.json 或新增了 includePaths，它不会自动重扫——必须手动关闭再打开 VS Code，或右键编辑器标签 → Reload Window，否则旧索引一直挂着，新符号永远不出现。
