WebStorm改HTML/CSS/JS后没反应，主因是自动保存未落盘或部署未同步：默认仅写缓冲区，需禁用safe write、勾选Synchronize files on frame activation、启用Mark modified，并确认Deployment中Upload changed files automatically已开启且路径配置正确。
WebStorm 改完 HTML/CSS/JS 文件后没反应，不是代码写错了，大概率是自动保存没真正落盘，或者部署路径根本没同步过去。
自动保存为什么没生效
WebStorm 的“自动保存”默认只写入内存缓冲区，不等于把文件刷到磁盘——构建工具（如 Vite、Webpack Dev Server）和浏览器监听的是文件系统事件，不是 IDE 缓冲区。常见失效原因：
-
Use "safe write"默认开启：先写临时文件再重命名，部分文件系统（尤其是 WSL、NTFS 挂载路径、网络盘）会漏掉这个事件 - 没勾选
Synchronize files on frame activation：切到浏览器或终端时不会保存，只能靠空闲计时，延迟不可控 -
Mark modified未启用：编辑器 tab 上没星号，你根本不知道哪些文件还没存 - 文件被外部进程独占锁定（比如另一程序正以写模式打开它），WebStorm 静默失败，只在 Event Log 底部闪一下
Cannot save file: Access is denied
部署 dist 到远程服务器前必须确认的三件事
用 WebStorm 的 Deployment 功能上传 dist 目录，不是点一下“上传”就完事。三个关键点卡住就会白忙活：
- Connection 中的
Root path必须是服务器上真实可写的绝对路径（如/var/www/html），不能是相对路径或带空格的路径 - Mappings 中的
Local path必须精确指向本地已构建好的dist目录（不是项目根目录，也不是src），且该目录存在、非空 -
Deployment path是相对于Root path的路径，如果想把dist内容直接铺到网站根目录，这里填/；如果要放到子目录（如/myapp），就得填/myapp，少一个斜杠或大小写错误都会上传失败
Debug 'index.html' 和 Deployment 是两套完全不互通的机制
很多人以为开了 Deployment 就能预览，或者 Debug 模式下改完代码自动同步到服务器——这两者毫无关系：
-
Debug 'index.html'走的是 WebStorm 内置服务器（默认localhost:63342），只用于本地热更新，不涉及任何远程路径或 FTP/SFTP 连接 - Deployment 配置里的
Web server URL仅用于生成可点击的链接，不影响 Debug 行为；它也不会让浏览器自动从远程服务器拉取文件 - 如果想让手机或同事访问你的页面，必须同时做两件事：① 在 Built-in server 设置里勾选
Can accept external connections并设端口（如8080）；② 在 Deployment 的 Connection 中把Web server root URL改成http://[你的本机IP]:8080，否则映射关系对不上
最常被忽略的是：Deployment 的 Mappings 只控制“上传什么”，不控制“什么时候上传”。除非勾选了 Upload changed files automatically，否则每次改完 dist 都得手动右键 → Upload to xxx，没有中间态。
