PHP自动补全失效主因是Intelephense索引异常、PHP路径错误或项目结构问题；需三步定位：确认服务状态、检查php.executablePath、验证composer.json与vendor/完整性。
PHP自动补全在VS Code中失效，**绝大多数情况不是插件坏了，而是Intelephense没索引完、路径没配对、或项目结构触发了语言服务器的“静默降级”**。修复它不靠重装，而靠三步定位：确认服务状态 → 检查PHP可执行路径 → 验证项目符号可见性。
为什么Intelephense显示“Indexing…”却一直不动？
这是最常见假死现象。Intelephense依赖本地PHP解释器解析composer.json和vendor/目录，若PHP路径错误或vendor/为空，它会卡在索引阶段，补全完全不响应。
- 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，切换到 Console 标签页，搜索Intelephense或error，看是否有PHP executable not found类报错 - 检查设置中
php.executablePath是否指向真实存在的php.exe（Windows）或php（macOS/Linux）。例如："php.executablePath": "C:\\xampp\\php\\php.exe"
- 确保项目根目录有有效的
composer.json，且已运行过composer install—— 没有vendor/，Intelephense 就像没地图的导航 - 重启VS Code后，观察右下角状态栏是否出现
Intelephense: Ready；若仍为Indexing…超过2分钟，尝试在设置中启用intelephense.environment.includePaths手动添加vendor/路径
类名、方法名能提示，但自定义函数/全局常量不出现？
这是因为Intelephense默认只索引命名空间类和vendor/，对functions.php、config/*.php这类非标准加载文件“视而不见”。
- 在项目根目录创建
.intelephense.json，显式声明需扫描的全局文件：{ "files.associations": { "*.php": "php" }, "environment.includePaths": [ "./app/helpers", "./config", "./bootstrap" ] } - 为全局函数加PHPDoc注释，哪怕只有一行：
/** * @return string */ function get_app_name() { ... }否则Intelephense无法推断返回类型，补全时直接跳过 - 避免在
include或require中使用变量拼接路径（如require $dir . '/functions.php'），这会导致静态分析失败，相关符号不会被索引
补全弹出但选项全是“any”、“mixed”，毫无参考价值？
这是类型信息丢失的典型表现，根源在于缺少类型声明或PHPDoc标注，尤其在PHP 7.4+弱类型环境下更明显。
立即学习“PHP免费学习笔记（深入）”；
- 优先使用PHP 7.4+的原生类型声明：
function calculateTotal(array $items, float $taxRate): float { ... }Intelephense对array、string、int等基础类型识别率远高于@var array - 对动态返回值（如
config('database.host')）必须补全PHPDoc：/** * @return array{host: string, port: int} */ function config(string $key) { ... } - 禁用老旧插件干扰：卸载
PHP Intellisense（已停止维护）、PHP Getters and Setters等可能劫持语言服务器的扩展；只保留PHP Intelephense和PHP Debug
真正卡住补全的，往往不是配置项本身，而是vendor/目录权限问题、项目路径含中文、或composer.json里autoload字段写错——这些细节不会报红，但会让Intelephense悄悄放弃索引。建议先用一个最小可复现项目（仅composer.json + index.php + vendor/）验证基础流程，再逐步叠加复杂结构。
