WebStorm需将Automatic Upload设为On explicit save action才能实现Ctrl+S同步上传，且仅对已映射路径生效；Deployment path须以/开头、与Root path配合正确，权限和Web服务器配置也必须匹配。
WebStorm 里没有「一键同步远程」的全局快捷键，Ctrl+S 本身不会触发上传，必须配合 Automatic Upload 的正确模式才能实现“保存即同步”——否则你按烂 Ctrl+S，文件也纹丝不动。
为什么 Ctrl+S 不上传？因为上传触发时机没设对
WebStorm 的 Automatic Upload 默认是 On frame deactivation 或 On application startup，这两个时机和你保存代码完全无关。真正响应 Ctrl+S 的只有 On explicit save action。
- 路径：Tools → Deployment → Options →
Upload changed files→ 改为On explicit save action - 这个选项只对「已配置映射的本地路径内」的文件生效；如果文件在
node_modules或未加入Mappings的子目录下，保存也不会上传 - 改完后，
Ctrl+S才真正变成“本地改→远程推”的闭环，但注意：它不拉取、不比对、不覆盖远程修改过的同名文件
Deployment path 必须以 / 开头，否则映射失效
Deployment path 是相对于 Root path 的路径，不是绝对路径，也不是相对当前项目的路径。填错会导致文件传到服务器上完全错误的位置，比如 Nginx 找不到静态资源、404 爆满。
- 若
Root path是/var/www/html，你想把本地dist/推到网站根目录，Deployment path必须填/（不是空、不是.、不是./） - 若要部署到子路径（如
https://example.com/admin），Deployment path填/admin，且Web server URL末尾也得是/admin - Windows 用户注意：这里一律用正斜杠
/，哪怕本地路径显示为C:\project，Deployment path仍写/my-app
Test Connection 成功 ≠ 能上传，权限和路径才是真门槛
点 Test Connection 显示绿色勾，只说明 SSH 登录成功，不代表你有权限写入目标目录，也不代表 Web 服务能读取那些文件。
- 上传失败常见报错：
Permission denied (publickey)→ 检查认证方式是否匹配（密钥登录却选了 Password）；Failed to upload file: Permission denied→ 用终端执行ls -ld /var/www/html看属主，必要时sudo chown -R $USER:$USER /var/www/html - 上传后访问 404：先确认
Root path和Deployment path拼出来的完整路径，是否和 Nginx/Apache 的root或DocumentRoot一致 - 别信
Auto-detect root path：某些容器或受限 shell 下它返回/，实际项目根本不在那里
想手动触发一次全量同步？用右键菜单，不是快捷键
WebStorm 没给“全量上传”分配快捷键，但你可以快速调出上下文菜单完成操作：
- 在项目工具窗口中，右键点击项目根目录 →
Deployment→Upload to <server-name> - 首次部署或重构目录结构后务必手动走一遍，验证路径、权限、服务状态三者是否连通
- 上传完成后，建议立刻在终端执行
curl -I http://your-domain.com/test.html确认 HTTP 响应头正常，而不是只看 WebStorm 日志里的 “Uploaded 12 files”
最常被忽略的一点：WebStorm 的同步是单向、无感知的。它不会告诉你远程文件已被其他人修改，也不会阻止你覆盖正在运行的服务配置。上线前务必人工校验关键文件，或者把部署流程交给 Git Hook + rsync 这类可审计的机制。
