PhpStorm默认不自动滚动项目树到当前文件，必须开启Autoscroll from Source（准星图标或View→Appearance→勾选），该功能依赖文件被正确索引、路径未被排除、Project面板可见且未折叠，phpstorm://协议跳转也需满足路径匹配和协议注册等前提。
PhpStorm 默认不会自动把项目树滚动到当前打开的文件位置，必须手动开启“Scroll from Source”才能同步视图。
开启 Autoscroll from Source 是唯一可靠方式
这个设置控制 Project 面板是否跟随编辑器焦点自动滚动并高亮当前文件。它不是“一次性点击生效”，而是需要启用后持续生效：
- 点击 Project 面板右上角那个准星图标
Scroll from Source，确保它处于高亮（激活）状态 - 或者通过菜单：
View → Appearance → Autoscroll from Source打勾 - 该功能在 2019.2 及之后所有稳定版（含 2026 年最新版）中默认关闭，且无 GUI 开关项，必须手动触发或设为常开
- 如果 Project 面板被折叠或隐藏，该功能不生效——需保证面板可见
为什么开了还是不跳？常见失效场景
即使开启了 Autoscroll from Source，仍可能无法定位，原因很具体：
- 当前文件不在项目索引范围内（比如刚拖进来的文件未被 PhpStorm 自动识别为项目成员）——执行
File → Reload project from Disk或右键目录点Reload from Disk - 文件路径包含符号链接（symlink），而 PhpStorm 索引的是真实路径——此时高亮可能错位或丢失
- Project 面板启用了
Flatten Packages或Hide Empty Middle Packages，导致路径结构被压缩，文件虽被高亮但视觉上“找不到”——临时关闭这些视图选项可验证 - 多窗口/多标签页环境下，仅当前活动编辑器标签会触发滚动；非焦点标签切换时不会主动刷新 Project 树
phpstorm:// 协议跳转也能触发同步，但有前提
用外部工具（如日志、文档、CI 报告）点击 phpstorm://open?file=/path/to/File.php&line=42 链接时，PhpStorm 会打开文件并定位光标，同时也会触发 Autoscroll from Source 行为——但前提是：
立即学习“PHP免费学习笔记（深入）”；
- 系统已正确注册
phpstorm://协议（Linux 需phpstorm-url-handler；macOS 需确认Preferences > Tools > Web Browsers and Preview > PHP Server URL Handler已启用） - 链接中的
file参数是绝对路径，且大小写完全匹配项目内实际路径 - 该文件已被索引（即出现在 Project 面板中），否则只打开空标签，不滚动也不高亮
真正容易被忽略的是：这个同步行为依赖于“文件在 Project 面板中存在可展开的路径节点”。如果某个目录被标记为 Excluded（右键目录 → Mark Directory as → Excluded），哪怕文件物理存在，Project 树也不会显示它，自然也无法滚动定位——检查排除状态比反复开关 Scroll from Source 更有效。
