PhpStorm自动上传需设为On explicit save action才稳定，Root path、Deployment path on server、Web path三者必须严格匹配，rsync可实现高效增量同步，时间戳偏差超60秒应关闭时间比对改用内容比对。
自动上传选 On explicit save action 才可控
PhpStorm 的「自动上传」不是开个开关就完事，真正起作用的是 Upload changed files automatically to the default server 这个选项，位置在 Settings → Build, Execution, Deployment → Deployment。关键在触发时机：
-
On file change表面全自动，实则高危：编辑器临时保存、插件自动加空格、格式化中途都会触发上传，PHP 文件传一半就被 Nginx 加载，直接报Parse error或空白页 -
On explicit save action（即按Ctrl+S）才是稳态选择：你确认写完了才传，配合手动保存节奏，杜绝半截文件上服务器 - 真有实时调试需求（如 WebSocket 接口联调），建议单独建轻量项目，并在
Excluded paths里填上vendor、node_modules、.git—— 不传这些，反而更准更快
路径映射三处必须严丝合缝
上传成功但浏览器 404？90% 是这三项没对齐。它们不是可选项，是硬性依赖关系：
-
Root path（Deployment → Connections 页）必须是远程绝对路径，例如/var/www/html/myapp；不能写~/public_html、public_html或漏开头的/ -
Deployment path on server（Mappings 页）若项目就部署在Root path下，这里必须填/；若子目录部署（如/myapp），就填对应子路径，不能留空 -
Web path for this project必须和 Web 服务器配置完全一致：Nginx 的root /var/www/html;+ 项目在/myapp，就得填http://example.com/myapp；少一个/，请求就会被重定向到首页
验证方法很简单：curl -I http://example.com/myapp/info.php 返回 200 才算过。
用 rsync 做增量同步要绕过 IDE 内置机制
PhpStorm 自带的上传是单文件粒度，不压缩、不跳过未改内容，大项目耗时明显。想真正做增量同步，得用终端走 rsync：
立即学习“PHP免费学习笔记（深入）”；
- 在 PhpStorm 内置终端执行：
rsync -avz --delete --exclude='vendor/' --exclude='node_modules/' ./ user@host:/var/www/html/myapp/ -
--delete确保远程删了本地也删，避免残留旧文件；--exclude避免同步巨目录，省带宽也提速 - 注意路径结尾的
/：./和/myapp/都带斜杠，否则 rsync 会把整个本地目录名当子目录传过去 - 首次同步前建议先
rsync -avn（dry-run 模式）看预估行为，避免误删
时间戳偏差超 60 秒时必须关掉时间比对
PhpStorm 默认用文件修改时间戳判断是否需要上传。但如果你的服务器时间与本地差超过 60 秒（常见于虚拟机、VPS 或时区未同步），它会反复判定“文件已变更”或“文件已过期”，导致无效上传甚至覆盖。
解决办法很直接：
- 进
Settings → Build, Execution, Deployment → Deployment → Options - 取消勾选
Compare files by time stamp - 改用内容比对（默认开启），虽然略慢一点，但逻辑可靠
这个点容易被忽略——界面没报错，上传也显示 success，但你改了一行，它却传了整个文件，就是时间戳失准在作怪。
