You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Intelephense 1.4及以上版本悬停菜单与函数声明跳转功能失效,无法升级版本求解决方案

针对Intelephense 1.4+悬停/跳转失效的解决思路

根据你描述的情况(1.3版本正常,升级后悬停无反应、无法跳转,已排除扩展冲突、重建索引),分享几个针对性的排查方向:

  • 检查扩展核心功能的配置开关
    新版本可能新增了控制悬停、跳转功能的配置项,你可以打开VS Code的设置(Ctrl+,),搜索以下配置,确保它们都设为true:

    • intelephense.hover.enabled:控制悬停信息是否开启
    • intelephense.goto.definition:控制跳转至定义的功能是否启用
      如果这些项被误设为false,就会导致你遇到的问题。
  • 核查索引的包含/排除规则
    Intelephense 1.4+的索引逻辑可能有调整,检查工作区设置里的以下配置,确认没有把函数所在的源码目录误排除:

    • intelephense.files.exclude:扩展专属的排除规则
    • files.exclude:VS Code全局的文件排除规则
      同时可以尝试手动指定需要索引的目录,比如在工作区settings.json中添加:
    "intelephense.files.include": [
        "src/**/*.php",
        "你的其他源码目录/**/*.php"
    ]
    

    强制扩展优先索引这些路径。

  • 清理扩展的缓存数据
    升级后旧的缓存文件可能和新版本不兼容,你可以:

    1. 打开VS Code命令面板(Ctrl+Shift+P),输入Extensions: Show Extensions Folder
    2. 找到Intelephense对应的文件夹(一般是intelephense.bmewburn.vscode-intelephense-client)
    3. 删除文件夹内的cache或storage目录
    4. 重启VS Code,等待扩展重新建立索引
  • 确认PHP版本兼容性
    Intelephense 1.4+可能提高了对PHP版本的要求,检查你的项目使用的PHP版本是否符合扩展的支持范围。可以在设置中指定项目的PHP版本:

    "intelephense.environment.phpVersion": "7.4" // 替换成你项目实际的PHP版本
    

    确保这个版本和扩展支持的版本匹配(可以查看Intelephense扩展详情页的说明)。

  • 提交Bug报告
    如果以上方法都无效,大概率是新版本的兼容性Bug。你可以去Intelephense的官方仓库提交Issue,附上以下信息方便开发者排查:

    • VS Code的具体版本
    • Intelephense的具体版本(1.4.x或更高)
    • 项目的PHP版本
    • 项目的大致文件结构
    • 重现问题的具体步骤

内容的提问来源于stack exchange,提问作者yoshi

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.04.29 13:17:34