Call Hierarchy 快捷键失效主因是光标未落在可解析的函数名上，需检查语法错误、索引状态、动态调用及位置精度；Caller/Callee 区分回溯调用者与展开被调用者；Find Usages 为文本匹配，Call Hierarchy 为真实调用流；Debug Frames 是运行时单路径快照，Call Hierarchy 是静态多路径分析。
Call Hierarchy 快捷键失效时怎么排查
按 Ctrl + Alt + H（Windows/Linux）或 Cmd + Option + H（macOS）没反应，大概率不是功能坏了，而是光标没落在可解析的函数名上。常见卡点有：
- 函数名被红色波浪线标记（语法错误、未声明、命名空间未引入），
Call Hierarchy不会触发 - 光标停在函数调用括号内、参数里或注释中，必须精确落在函数名字母上
- 项目尚未完成索引——底部状态栏显示 “Scanning files” 时，所有导航类功能都不可靠
- 函数是动态调用（如
call_user_func、$obj->$method()），PhpStorm 默认不分析这类间接调用
临时验证方式：把光标放上去，按 Ctrl + 左键 能否跳转到定义；不能，则先解决符号解析问题。
Caller Hierarchy 和 Callee Hierarchy 的实际区别
Caller Hierarchy 回溯“谁调用了它”，适合查入口、定位触发点；Callee Hierarchy 展开“它调用了谁”，适合看副作用、依赖扩散。两者在同一个窗口切换，但行为差异直接影响分析方向：
- 选
Caller Hierarchy后，顶层节点是你当前函数，往下展开的是它的直接/间接调用者，比如processOrder()→handlePayment()→index.php - 选
Callee Hierarchy后，顶层仍是当前函数，往下是它内部调用的函数，如calculateTotal()→getTaxRate()→getConfig() - 若某节点灰色且带「(not resolved)」，说明该调用目标未被索引到（常见于 trait 方法、魔术方法或条件加载的类）
注意：Callee Hierarchy 对私有方法、final 方法更敏感；而 public/static 方法通常能完整展开。
立即学习“PHP免费学习笔记（深入）”；
Find Usages 和 Call Hierarchy 结果不一致怎么办
Find Usages（Alt + F7）返回所有文本匹配位置，包括字符串、注释、测试桩里的假调用；Call Hierarchy 只识别真实执行流中的调用关系。不一致不是 bug，是设计使然：
- 如果
Find Usages里有大量结果但Call Hierarchy是空的，检查是否用了动态调用、字符串拼接函数名，或方法被重命名但引用未更新 - 如果
Call Hierarchy显示了某调用，但Find Usages没列出来，大概率是该调用来自另一个模块且未被当前作用域包含（比如 composer 包里的代码没加进 PhpStorm 的「Sources」根目录） - 右键函数名选
Find Usages in Hierarchy可强制包含子类重写的方法调用，这比普通Find Usages更接近Call Hierarchy的语义
调试建议：先用 Find Usages 确认符号是否被全局识别，再切到 Call Hierarchy 看真实调用路径。
调试中看到的 Frames 和 Call Hierarchy 不一样
运行时 Debug → Frames 标签页展示的是**此刻栈帧快照**，完全取决于断点停在哪一行；而 Call Hierarchy 是**静态分析结果**，基于整个项目的代码结构推导出所有可能路径。二者天然不同：
-
Frames中的调用链是确定的、单条路径，顶部是当前执行行，底部是请求入口（如public/index.php） -
Call Hierarchy是多路径树，包含所有可能分支，哪怕某些分支在当前请求中根本没走（比如 if 分支未命中、异常未抛出） - 如果某函数在
Frames里出现，但在Call Hierarchy中找不到，说明它可能是通过反射（ReflectionMethod::invoke）、闭包或 eval 动态执行的——这些无法被静态分析捕获
真正要盯住的，是那些在 Frames 里高频出现、但 Call Hierarchy 中层级过深或路径异常绕的节点——那往往是性能或耦合问题的信号。
