Smart Step Into 是 PhpStorm 在单行多函数调用时自动弹出选择框以精准进入目标函数的调试功能，需在 Settings → PHP → Debug → Stepping 中启用并勾选“Always use smart step into”，它不替代 Force Step Over，而是互补配合使用。
Smart Step Into 是什么，什么时候必须用它
当你在一行里写了多个函数调用（比如 foo(bar(baz())) 或 $user->getName()->trim()->toUpperCase()），按常规 Step Into（F7）会弹出选择框，让你挑进哪个函数——这不是 bug，是 PhpStorm 的主动保护。它默认不猜你意图，避免误钻进你不关心的底层方法。如果你总想跳进最内层、或固定某一个调用，又不想每次点选，就得靠 Smart Step Into。
怎么启用并控制 Smart Step Into 行为
它不是开箱即用的，默认要手动配。关键路径在 Settings → PHP → Debug → Stepping → Smart step into。这里有两个核心开关：
- 勾选 Enable smart step into：开启功能本身
- 勾选 Always use smart step into when multiple calls are present：让 PhpStorm 每次都自动弹选择框，而不是只在你右键菜单里手动触发
注意：这个设置只影响「当前行有多个可进入调用」的场景；单个函数调用时，Step Into 仍走原逻辑，不会被覆盖。
为什么点了 Smart Step Into 还进错函数
常见原因不是配置失效，而是 PhpStorm 对“可进入调用”的识别有边界：
立即学习“PHP免费学习笔记（深入）”；
-
__construct()、__get()等魔术方法默认被跳过，除非你在 Settings → PHP → Debug → Step Filters 中取消勾选对应项 - vendor 包里的函数（如
Illuminate\Support\Str::of()）若没关掉 Ignore external libraries，也会直接跳过，不列入选择列表 - 静态调用和实例方法混合时（如
Helper::format($x)->toHtml()），有时只把链式调用的后半段当候选，前半段Helper::format()可能被忽略——这时建议拆成两行再调试
Smart Step Into 和 Force Step Over 的配合使用
它们不是替代关系，而是互补策略。Smart Step Into 解决「该进哪一个」，Force Step Over（右键行号 → Force Step Over，或 Shift+F7）解决「这一整行我全当黑盒，一跳到底」。实际调试中常这样组合：
- 先用
Step Over（F8）走到含多调用的行 - 按 F7 弹出 Smart Step Into 选择框，挑中你要进的函数
- 进去后发现里面全是第三方逻辑？立刻右键该行 →
Force Step Over，跳过内部细节，回到你自己的代码流
真正容易被忽略的是：Smart Step Into 的选择框一旦出现，你必须点选或按 Esc 取消，否则调试会卡住不动——这不是卡死，是等待你决策，但界面提示极轻，容易误判为 IDE 假死。
