必须开启Autoscroll to Source才能自动高亮当前编辑文件，它持续监听焦点并自动滚动展开路径；误开功能相反的Autoscroll from Source则无反应，且仅对当前项目生效。
Autoscroll to Source 开关必须打开
WebStorm 默认不自动高亮当前编辑文件，必须手动启用 Autoscroll to Source。它不是“点一下就定位”的瞬时操作，而是持续监听编辑器焦点的后台行为——只要开启，你切到任意文件，左侧 Project 树就会自动滚动、展开路径、高亮节点。
常见误操作：Autoscroll from Source 名字相近但功能相反（点击左侧节点才跳转到编辑器），勾错就完全没反应。别被名字带偏。
- 路径：Project 工具窗口右上角齿轮图标 → 勾选
Autoscroll to Source - 生效范围：仅当前项目有效；新建项目需重新勾选（除非你在 IDE Settings → Appearance & Behavior → System Settings 中设为默认）
- 验证方式：打开一个嵌套很深的文件（比如
src/pages/dashboard/ChartCard.tsx），看左侧是否自动展开到对应层级并高亮
为什么点了文件还是不跳？先看文件是否“被认作项目文件”
即使 Autoscroll to Source 开着，如果当前编辑的文件不在项目的 Content Root 下，WebStorm 就不会把它和左侧目录关联起来——它压根不认为这是“项目的一部分”。
- 检查路径：File → Project Structure → Modules → Sources，确认该文件所在目录已标记为
Sources（蓝色图标） - 典型陷阱：把日志、临时脚本、
node_modules里的文件拖进编辑器，或文件位于Excluded目录（灰色图标）下 - 现象：光标在文件里，但左侧 Project 树无任何滚动/高亮，Alt + F1 弹窗也为空或只显示
Scratches and Consoles
汉化版 UI 里那个“靶心图标”是快捷开关，不是永久方案
2022 年后版本在 Project 窗口顶部加了个圆圈图标（Reveal in Project View），点一下能强制定位当前文件。但它只是单次手动触发，不替代 Autoscroll to Source 的持续跟踪能力。
- 适合场景：临时查一个文件位置，或
Autoscroll to Source被意外关闭时救急 - 不能依赖它解决日常定位问题——每次都要点，且不自动展开父级路径
- 汉化版里这个按钮可能被翻译成“在项目视图中显示”或“定位到项目视图”，位置固定在 Project 窗口标题栏右侧
插件或系统快捷键冲突会让整个机制“静默失效”
Autoscroll to Source 没有失败提示，关了也不报错，只是“看起来没反应”。最容易被忽略的是它被其他东西劫持了：
- GitToolBox、Vim Emulator 等插件可能覆盖
Alt + F1或干扰焦点事件，临时禁用插件可验证 - macOS 的 Mission Control（调度中心）会吃掉
Cmd + Option + ←/→，间接影响 WebStorm 对编辑状态的感知（尤其在跳转后自动居中逻辑里） - Linux 桌面环境（GNOME/KDE）常把
Ctrl + Shift + Backspace绑定为工作区切换，导致“上次编辑位置”跳转异常，连带影响定位稳定性
真正卡住的时候，别急着重装或改配置，先去 Project 窗口齿轮里确认 Autoscroll to Source 是开着的——这个动作比查日志快十倍，而且八成就是它。
