WebStorm 默认不自动同步外部工具对文件的修改，因其采用主动缓存策略并依赖系统级事件监听；可通过快捷键 Ctrl+Alt+Y 刷新、启用窗口激活自动同步或手动 Reload from Disk 解决。
WebStorm 默认不会自动感知并加载外部工具（比如命令行 git checkout、npm run build、VS Code 编辑、甚至系统文件管理器）对项目文件的修改，导致你看到的代码仍是旧版本——这不是 bug，而是 IDE 为避免频繁重载做的主动缓存策略。
为什么外部修改不刷新？
WebStorm 把文件变更监听交给自己的 FS watcher（基于 inotify/macOS FSEvents），但它默认只响应「IDE 内部操作」或「显式触发的 VCS 操作」；外部写入若未触发系统级事件（如某些容器挂载、远程同步工具、硬链接替换），IDE 就会卡在旧状态。常见现象包括：
- 终端执行
git checkout main后，WebStorm 文件内容没变，右下角分支名却已更新 - 用 VS Code 改了
package.json，WebStorm 的依赖树和 npm tool window 不更新 -
npm run build输出了新dist/文件，但 WebStorm 的 Project 视图里仍显示“文件不存在”
VCS → Git → Refresh File Status（Ctrl+Alt+Y）
这是最轻量、最安全的强制同步动作，它不改变 Git 状态，只让 IDE 重新扫描工作区文件哈希与磁盘实际内容比对：
- 适用场景：Git 切换分支、rebase 后文件内容未更新，或本地有未提交修改但想确认真实状态
- 它会刷新 Local Changes 工具窗口（Alt+9）、编辑器高亮、diff 标记，但不会 reload editor tabs
- 如果文件被外部删掉，它会立刻标红；如果新增了文件但未
git add，它会在 Local Changes 里显示为 Unversioned - 快捷键
Ctrl+Alt+Y（Windows/Linux）或Cmd+Alt+Y（macOS）可秒级触发，无需弹窗
Enable “Synchronize files on frame activation”
这个选项能让 WebStorm 在你切回 IDE 窗口时自动检查磁盘变更，适合高频外部协作场景（如同时开终端 + WebStorm + Docker logs）：
- 路径：
Settings → Appearance & Behavior → System Settings → Synchronize files on frame activation - 启用后，每次 Alt+Tab 回到 WebStorm，它会做一次轻量级文件时间戳比对（非全量扫描），延迟通常
- 注意：它只检测「是否变更」，不自动 reload；你需要手动按
Ctrl+Alt+Y或点击编辑器右上角的「Reload file」图标 - 不建议在大项目（>10k 文件）中开启，可能引发轻微卡顿；小项目或前端单页应用可放心开
终极方案：关闭 Auto-saved files 并手动 Reload
当上述都不生效（比如文件被硬链接替换、或 NFS 挂载延迟），说明 IDE 的 watcher 彻底失灵，此时必须绕过缓存机制：
- 先关掉「Auto-save」：
Settings → Appearance & Behavior → System Settings → Save files on focus loss和Save files automatically if application is idle for …全部取消勾选 - 然后右键编辑器 tab →
Reload from Disk，或选中文件 →File → Reload from Disk - 对整个目录：在 Project 视图中右键文件夹 →
Reload from Disk（会递归刷新所有子文件） - 危险提示：若当前文件有未保存的编辑内容，
Reload from Disk会直接丢弃——务必先确认无未存草稿
真正容易被忽略的是：WebStorm 的文件监听能力高度依赖底层 OS 的事件通知机制。Linux 上用 inotify（默认上限 8192），macOS 上用 FSEvents（对某些网络文件系统支持弱），Windows 上靠 ReadDirectoryChangesW（对 WSL2 挂载路径常失效）。遇到顽固不同步，别只盯着 IDE 设置，先查 inotifywait -m . 或系统日志，确认变更是否真被 OS 捕获了。
