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 将弹出悬浮提示框。
立即学习“PHP免费学习笔记(深入)”;
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
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 分行列出,差异处即为推断介入点。










