WebStorm自动保存需关闭“safe write”、确保文件系统可监听、避开NTFS挂载路径，否则构建工具无法及时捕获变更。默认safe write导致临时文件重命名被监听器遗漏，尤其在WSL/SSH环境下；应禁用safe write，启用失焦保存，并将项目置于原生文件系统路径。
WebStorm 的“自动保存”不是开关一开就万事大吉的——它默认只在失去焦点或执行某些操作时才写入磁盘，不等于实时同步到文件系统，更不保证其他进程（如构建工具、本地服务器）能立刻看到变更。
为什么改了代码但 npm run dev 没反应？
这是最常被误解的一点：WebStorm 的 Save files on frame deactivation 或 Save files automatically if application is idle for N sec 只控制 IDE 内部何时把缓冲区内容刷到磁盘，但 Node.js、Vite、Webpack Dev Server 等工具依赖的是文件系统事件（inotify / FSEvents）。如果 WebStorm 启用了 Use "safe write"（默认开启），它会先写入临时文件再原子重命名——这个过程可能被部分监听器漏掉，尤其在 WSL 或网络文件系统上。
- 进设置：
Settings / Preferences → Appearance & Behavior → System Settings - 取消勾选
Use "safe write" (save changes to a temporary file first) - 勾选
Save files on frame deactivation（切出窗口即保存） - 或启用
Save files automatically if application is idle for...，建议设为1秒
Ctrl+S 不生效？检查键盘映射和文件只读状态
手动按 Ctrl+S 失败，往往不是功能坏了，而是被拦截或条件不满足：
- 确认当前文件没被标记为
Read-only（右下角状态栏有锁图标，或文件属性含readonly） - 检查是否误启用了
Power Save Mode（菜单File → Power Save Mode，开启后禁用所有后台任务，包括自动保存） - Mac 用户注意：系统级快捷键（如截图、Mission Control）可能劫持
Cmd+S，可在System Settings → Keyboard → Shortcuts中排查 - 若用 Vim 插件，
Ctrl+S默认被绑定为suspend，需在Settings → Keymap中搜索SaveAll并重新绑定
远程开发（SSH/WSL）下保存延迟高怎么办？
在 WSL2 或通过 SSH 连接远程解释器时，safe write + 文件系统跨层同步容易引发卡顿或丢失变更。此时必须调整底层行为：
- 关闭
Use "safe write"（再次强调，这是关键） - 在
Settings → Languages & Frameworks → JavaScript → Libraries中，禁用Download library sources automatically，避免保存时触发后台下载 - WSL 用户建议将项目放在
/home/xxx/下，而非/mnt/c/—— NTFS 挂载点的 inotify 事件支持极差 - 远程 SSH 项目：在
Settings → Deployment → Options中，取消Upload external changes automatically，改用On explicit save action避免竞争
真正影响同步效果的，从来不是“有没有自动保存”，而是“以什么方式落盘”和“外部监听器能否可靠捕获”。关掉 safe write、确认文件系统可监听、避开挂载路径——这三步做完，90% 的“改了不生效”问题就消失了。
