PhpStorm悬停查看变量类型方法详解

文章小白一枚，正在不断学习积累知识，现将学习到的知识记录一下，也是将我的所得分享给大家！而今天这篇文章《PhpStorm查看变量类型方法_悬停查看步骤详解》带大家来了解一下##content_title##，希望对大家的知识积累有所帮助，从而弥补自己的不足，助力实战开发！

PhpStorm 支持通过悬停、快捷键、PHPDoc 注解、设置检查及 Quick Definition 五种方式查看变量类型：悬停显示 Type；Ctrl+Shift+P/Cmd+Shift+P 弹出类型面板；添加 @var 等注解增强推断；需启用 PHP 7.4+ 及类型推断选项；Ctrl+Shift+I/Cmd+Y 查看定义上下文中的声明与推断类型。

如果您在 PhpStorm 中编写 PHP 代码时希望快速确认某个变量的类型，可通过内置的类型推断机制与悬停提示功能实时获取。以下是查看变量类型推断的具体操作步骤：

一、悬停查看变量类型

PhpStorm 在编辑器中支持鼠标悬停自动显示变量的推断类型，该功能基于 PHPDoc 注释、赋值语句、函数返回值及 PHP 7.4+ 的类型声明进行静态分析。

1、将鼠标光标停留在目标变量名上（例如 $user 或 $items）。

2、保持静止约 300 毫秒，PhpStorm 将弹出悬浮提示框。

3、在提示框顶部查看 Type: 后跟随的完整类型信息，如 App\Models\User 或 array。

二、使用快捷键强制触发类型提示

当悬停未自动触发或需在无鼠标环境操作时，可使用键盘快捷键主动调出类型信息面板，确保类型推断结果可见且可复制。

1、将光标置于变量名称任意位置（不选中，仅定位）。

2、在 Windows/Linux 上按 Ctrl + Shift + P，在 macOS 上按 Cmd + Shift + P。

3、弹出的面板中将明确显示该变量的推断类型、来源（如来自 PHPDoc、return 类型或 new 表达式）及是否为可空类型。

三、启用 PHPDoc 类型注解增强推断精度

PhpStorm 依赖 PHPDoc 中的 @var、@param 和 @return 注解补充类型信息，尤其对动态赋值、数组访问或魔术方法返回值至关重要。

1、在变量声明前一行添加 PHPDoc 块，例如：
/** @var User $admin */

2、对函数参数添加注解：
/** @param array $config */

3、保存文件后，PhpStorm 将立即重新分析并更新悬停与快捷键提示中的类型信息。

四、检查类型推断是否启用

若变量始终显示为 mixed 或无类型提示，可能因项目语言级别或索引设置导致推断被禁用或降级。

1、进入 File → Settings → Languages & Frameworks → PHP（macOS 为 PhpStorm → Preferences → Languages & Frameworks → PHP）。

2、确认 Language level 设置为 PHP 7.4 或更高版本。

3、勾选 Enable PHP type inference 选项，并点击 OK 应用设置。

五、查看变量类型在“Quick Definition”中

PhpStorm 提供“Quick Definition”视图，可展示变量定义处的完整上下文，包括类型声明、PHPDoc 及实际赋值表达式，辅助验证推断来源。

1、将光标置于变量名上。

2、按下 Ctrl + Shift + I（Windows/Linux）或 Cmd + Y（macOS）。

3、在弹出窗口中观察左侧类型标识栏，其中 Declared type 与 Inferred type 分行列出，差异处即为推断介入点。

到这里，我们也就讲完了《PhpStorm悬停查看变量类型方法详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！