autoscroll to source 必须开启且文件目录标记为 sources 才能自动滚动并高亮当前编辑文件；误开 autoscroll from source 或目录被 excluded 会导致功能失效，alt+f1 和 reveal 按钮仅为临时补救。
Autoscroll to Source 必须开启，否则自动定位不生效
WebStorm 默认不自动高亮当前编辑文件，Autoscroll to Source 是唯一能持续跟踪并滚动展开路径的机制。它不是“点一下就跳”的瞬时动作，而是后台常驻行为：你切到 src/api/user.ts，左侧 Project 树立刻展开 src → api → 高亮 user.ts。
常见错误是误开 Autoscroll from Source（名字相近但功能相反：点击目录才跳转到编辑器），勾错后整个功能看起来“完全没反应”。
- 开关位置：Project 工具窗口右上角齿轮图标 → 勾选
Autoscroll to Source - 反向功能
Autoscroll from Source必须关闭，二者同时开启会互相干扰 - 仅对当前项目生效；新建项目需重新勾选，除非你在
IDE Settings → Appearance & Behavior → System Settings中设为默认 - 验证方式：打开一个嵌套路径如
src/pages/dashboard/ChartCard.tsx，观察左侧是否自动滚动并高亮
文件不在 Content Root 下，Autoscroll to Source 也无效
即使 Autoscroll to Source 开着，如果当前文件未被 WebStorm 认作“项目文件”，它根本不会尝试定位——左侧树连响应都没有。
典型场景包括：把临时脚本拖进编辑器、在 node_modules 里打开文件、或文件所在目录被标记为 Excluded（灰色图标）。
- 检查路径：
File → Project Structure → Modules → Sources，确认该文件目录有蓝色图标（即标记为 Sources） - 若为灰色图标，右键目录 →
Mark as → Sources或取消Excluded - 单文件模式（直接拖 .js 进 IDE）下，项目根可能退化为用户主目录，导致路径关系混乱
- 现象：
Alt + F1弹窗为空，或只显示Scratches and Consoles，说明 IDE 根本没把它纳入项目上下文
临时救急：Reveal in Project View 按钮只做单次定位
汉化版 UI 中那个“靶心”或“在项目视图中显示”按钮（Reveal in Project View）是手动触发的一次性操作，不能替代 Autoscroll to Source。
它适合临时查一个文件位置，比如刚关掉自动滚动、或某次切换失灵时快速补救。
- 位置固定在 Project 窗口标题栏右侧，图标为圆圈加箭头
- 点击后强制滚动并高亮当前文件，但不自动展开父级路径（有时需手动点三角展开）
- 无法解决日常高频切换问题——每次都要点，且不维持状态
- 别依赖它设置工作流；它是备选，不是主力方案
为什么 Alt+F1 → Project View 不推荐作为常规方案
Alt+F1 调出 Select Target 菜单再选 Project View，确实能跳转，但它本质是模拟一次手动查找，而非建立上下文关联。
这个操作在大型项目里延迟明显，尤其当 Project 树已折叠多层时，它只是把焦点给到 Project 窗口，并不保证滚动到位或高亮准确节点。
- 性能损耗：每次触发都要重建导航路径索引，比
Autoscroll to Source的增量监听慢得多 - 无状态：不记忆上次位置，也不联动其他工具（如 Git 工具窗口或 Terminal 的路径同步）
- 快捷键冲突风险：
Alt+F1在部分 Linux 桌面环境被系统捕获，导致失效 - 真正省事的方式只有一个：让
Autoscroll to Source一直开着，其他都是绕路
