Alt+F7可直接查找变量使用位置：光标置于变量名上按该快捷键，WebStorm自动分析作用域与引用关系，列出read/write/declaration等类型结果；局部变量限本文件，导出变量跨文件扫描，TS类型别名需先跳转定义再查。
其实，这事儿比你想的简单：直接按 Alt+F7 就能列出所有用法，根本不需要额外配置或插件。
怎么快速触发查找变量使用位置
操作起来毫无门槛：把光标放在变量名上（甚至不用全选），直接按下 Alt+F7。接下来，WebStorm 会自动完成所有分析工作——它会扫描当前作用域、追踪导入关系、解析类型定义，然后生成一份清晰的调用列表。
- 如果变量是局部的，那么结果只会老老实实地待在当前文件里，展示所有的读写操作。
- 但如果是模块导出的变量（比如
export const API_URL），情况就不同了。WebStorm 会启动跨文件扫描，把所有import和直接引用的地方都给你找出来。 - 不过，对于 TypeScript 的类型别名或接口，
Alt+F7默认是不处理的。这时候，你得先用Ctrl+Click跳转到定义，然后再查。 - 当然，右键菜单里也有 “Find Usages” 选项，功能和快捷键一样，但响应速度通常会慢半拍，日常操作不推荐用它。
结果窗口里哪些信息最值得看
按下快捷键后，默认会弹出一个 “Find” 工具窗口。这个窗口通常分为三栏，信息量很足：左侧是文件路径，中间是具体的行号和上下文代码片段，右侧则是一些关键的类型标记，比如 read、write、declaration。
- 看到
read标记，意味着该处只是读取了变量的值，比如console.log(x)。 - 而
write标记则代表赋值或修改操作，例如x = 5或者x.push(1)。 - 如果你在结果里看到了
declaration，那说明你刚才光标放的位置恰好是变量声明本身。这不是使用位置，想查用法的话，换个非声明的地方再试一次就行。 - 点击任意一条结果，编辑器会自动跳转到对应行并高亮显示；如果双击，则会直接在新标签页中打开那个文件，非常方便。
为什么有时候找不到明明用了的地方
遇到查不到的情况，先别急着怀疑功能失效。更常见的原因，其实是 WebStorm 的索引机制或者某些语言特性在“作祟”：
- 文件没被纳入项目范围：检查一下文件右下角是否显示着 “Excluded” 或 “Not in project”。如果是，在目录上右键，选择 “Mark Directory as → Sources Root” 通常就能解决。
- 动态属性访问不识别：像
obj[variableName]或obj[config.key]这种写法，静态分析工具很难追踪，所以不会出现在Alt+F7的结果里。 - 字符串拼接式引用：例如
eval('console.log('+varName+')')，这已经超出了常规静态分析的能力范围。 - TypeScript 中的模糊类型：如果变量被声明为
any或unknown类型，类型系统提供的线索太少，查找范围自然会大幅缩水。
话说回来，真正让人头疼的，往往是那些“看似用了、实则没进索引”的边缘情况——比如刚新建的文件还没来得及保存，或者变量改名后，其他文件的 import 路径没有同步更新。遇到这种查不到的时候，有个小技巧：先按 Ctrl+Shift+O 手动触发一次重新索引，这比反复重试要省时高效得多。
