Ctrl+Shift+I 在 PhpStorm 中触发「Quick Definition」轻量面板显示变量类型信息，包括 PHPDoc @var、赋值推断及返回值类型，需光标落在变量名词根上且 PHP 版本 ≥7.4。
Ctrl+Shift+I 查看变量推断类型（不是定义源）
这个快捷键在 PhpStorm 里实际触发的是「Quick Definition」，它不跳转、不打开新窗口，而是直接在光标附近弹出一个轻量面板，显示当前符号的类型信息——包括 PHPDoc @var 注解、赋值推断结果、返回值类型等。它和 Ctrl+B（跳转声明）是两回事，别按错。
常见错误现象：
• 光标停在 $user->name 的点号上或括号内 → 弹出空面板或报“no definition found”
• 变量未赋值或类型模糊（如 $data = json_decode($json)）→ 显示 mixed 或 object，没进一步提示
• 使用了 PHP 7.3 或更低版本 → 类型推断能力弱，Ctrl+Shift+I 返回的信息极简甚至缺失
- 确保光标落在变量名完整词根上（比如
$items的$后第一个字母i上） - PHP 版本需设为 7.4+（Settings → Languages & Frameworks → PHP → CLI Interpreter → Language level）
- 若想强制增强推断，给变量加
@var注解：例如/** @var \App\Models\User $user */
悬停查看 Type: 提示比快捷键更及时
鼠标悬停在变量上约 300ms，就会自动弹出 tooltip，顶部明确标着 Type: 后跟完整类型路径（如 \Illuminate\Database\Eloquent\Collection|\App\Models\Post[]）。这比按快捷键更快，且能同时看到 PHPDoc 描述、来源文件行号、是否 nullable 等附加信息。
容易踩的坑：
• 悬停时手抖移开鼠标 → 提示消失，得重等；建议调高 Settings → Editor → General → Mouse → “Show quick documentation on mouse move” 的 delay 值（比如设成 500ms）
• 在 Blade 模板里悬停 {{$post->title}} 中的 $post → 默认不生效，需先启用 Blade 支持（Settings → Languages & Frameworks → PHP → Blade → Enable Blade support）
• Laravel 的动态属性（如 Eloquent 的 $model->custom_attribute）不会被悬停识别，除非你写了 @property 注解
立即学习“PHP免费学习笔记（深入）”；
Ctrl+P 不是看类型，是看函数参数
Ctrl+P 的作用是显示当前函数/方法的参数签名和默认值，不是变量类型。但它常被误当成“看类型”的入口——尤其当你光标停在 array_filter($items, ...) 的 array_filter 上时，Ctrl+P 会告诉你第一个参数必须是 array|ArrayAccess，第二个是 callable。这间接帮你确认 $items 应该是数组，但不是直接查变量本身。
使用场景：
• 调用一个你不熟悉的框架方法（如 collect()、tap()）时，快速确认入参约束
• 函数有多个重载签名（如 PHP 8.2 的 str_contains()），Ctrl+P 会列出全部变体
• 参数带类型声明（如 function foo(string $s, ?int $i = null)），Ctrl+P 直接显示 string 和 ?int
- 光标必须落在函数名上，不能停在括号或逗号后
- 如果函数没有类型声明也没有 PHPDoc，
Ctrl+P就只显示 “(…)”，无实质信息 - 对魔术方法（如
__get）或动态调用（$obj->{$method}()）无效
类型推断失效时，别硬等 IDE，先看赋值源头
PhpStorm 的类型推断本质是静态分析，它不执行代码。一旦遇到运行时决定类型的情况（如 $x = $condition ? new User() : new Post();），IDE 就只能标 User|Post 或退化为 object。这时候快捷键再快也没用，得人工介入。
实操建议：
• 找到变量首次赋值的位置（Ctrl+B 跳过去），看右边表达式是否含条件分支、反射、unserialize()、json_decode() 等不确定操作
• 如果是第三方库返回值（如 Guzzle 的 Response::json()），手动补 @var 注解比等 IDE 推断更可靠
• 对泛型类（如 Collection<User>），确保用了 PHPStan 或 Psalm 插件，并开启严格模式，否则 PhpStorm 默认不解析尖括号内的类型
最常被忽略的一点：类型提示只对当前作用域有效。在一个闭包里 use ($user)，外部的 $user 类型不会自动透传进闭包内部——你得在闭包里单独写注解或重新赋值。
