删掉 Deployment 配置本身最干净：出错后直接删除旧配置（File → Settings → Deployment → 选中条目点“-”），清缓存重启，再严格按 Root path、Deployment path on server、Web path 三者均为完整绝对路径且一致的要求重配，并通过 curl -I 验证 200 响应。
删掉 Deployment 配置本身最干净
远程部署配置出错后，很多人试图“改对”，结果越改越乱——路径映射、Root path、Web path 三处斜杠多一个少一个，Deployment path on server 填成 ~/public_html 这种 shell 别名，或者 SFTP 用户被 chroot 到 /var/www 却在 PhpStorm 里填了 /var/www/html/myapp，这些都导致上传静默失败或 404。直接删掉重配比修配置快得多。
操作路径：File → Settings → Build, Execution, Deployment → Deployment（macOS 是 PhpStorm → Preferences），选中错误的服务器条目，点左上角 - 按钮删除。别留着“备用”，它会干扰新配置的自动识别。
删完记得清缓存：菜单栏 File → Invalidate Caches and Restart → Invalidate and Restart。否则旧的路径映射可能残留在内存里，新配置仍读到错误的 Deployment path。
删完重配时必须核对的三个绝对路径
重配不是填完表单就完事。这三项必须是完整、准确、一致的绝对路径，且不能含 ~、./ 或相对写法：
立即学习“PHP免费学习笔记（深入）”；
-
Root path（Connections 标签页）：远程服务器上你有写权限的真实目录，例如/var/www/html/myapp -
Deployment path on server（Mappings 标签页）：若项目就在Root path下，这里必须填/；若项目在子目录，比如/var/www/html/myapp/src，那这里就得填/src，不能留空 -
Web path for this project（Mappings 标签页）：必须和 Nginx 的root或 Apache 的DocumentRoot完全匹配。比如 Nginx 配了root /var/www/html;，项目在/myapp，这里就得填http://example.com/myapp，结尾不加斜杠
验证方法：上传一个 info.php，用终端跑 curl -I http://example.com/myapp/info.php，返回 200 才算对齐。
上传失败时先看 Deployment Log，别猜
上传显示 “Uploaded 1 file” 但远程文件没变？不是 PhpStorm 坏了，是它默认静默处理失败。真正原因藏在日志里：
打开 View → Tool Windows → Deployment → Log，重点扫这几类报错：
-
Permission denied：远程目录权限不对，或用户被限制写入（如 chroot 后没给www-data权限） -
No such file or directory：Root path或Deployment path路径错，或远程目录根本不存在（PhpStorm 不会自动创建父级目录） -
Connection timed out：SSH 端口不通，或服务器防火墙/安全组没放行 22 端口 -
Auth fail：私钥格式不对（必须是 OpenSSH，不是 .ppk）、密钥文件权限不是600、或密码输错
Log 里没报错但文件时间戳没更新？可能是远程用了 NFS 或 Docker volume，文件系统不支持 mtime，这时得关掉 PhpStorm 的“基于时间戳比对”，改用内容比对（在 Deployment → Options 里勾选 Upload files only if content differs）。
自动上传开关别乱开，On explicit save action 是底线
On file change 看着省心，实际是多数同步失败的源头。编辑器自动保存、格式化、插件补全都会触发上传，PHP 文件传到一半就被 Web 服务读取，立刻报 Parse error 或空白页。
正确做法：
- 只勾选
Upload changed files automatically to the default server - 下拉选
On explicit save action（即按Ctrl+S才传） - 手动上传快捷键是
Ctrl+Shift+Alt+Y（Windows/Linux）或Cmd+Shift+Alt+Y（macOS），比等自动更可控 - 把
vendor、node_modules、.git加进Excluded paths，它们不该走 SFTP
远程调试或 Composer 依赖管理这类操作，从来就不该靠上传触发——它们需要明确的 CLI 命令执行，不是文件同步能解决的。
