2024年12月版PhpStorm服务器部署路径错误问题

问题重现 #

使用2024年12月版PhpStorm部署时，设置本地根路径为/、远程部署路径为/welcome，期望文件上传至服务器/home/user/public_html/welcome（对应网站路径xyz.com/welcome），但实际被传到/home/user/，FTP软件可正常操作，旧版本教程界面不符无法参考。

解决步骤 #

• 修正服务器根路径配置
  打开Settings/Preferences > Build, Execution, Deployment > Deployment，选中你的远程服务器：
  切换到「Connection」标签，将「Root path」设置为服务器上public_html的绝对路径，比如/home/user/public_html，而非默认的/——之前设/会指向服务器系统根目录，而非网站根目录，这是核心问题。

• 调整路径映射规则
  切换到「Mappings」标签：

  • 「Local path」选择本地项目根目录；
  • 「Deployment path on server [服务器名]」设为/welcome（此时服务器根目录已指向public_html，所以该路径对应/home/user/public_html/welcome）；
  • 「Web path on server」设为/welcome（匹配网站访问路径xyz.com/welcome）。

• 验证与测试
  配置完成后，右键本地文件选择Deployment > Upload to [服务器名]，登录服务器检查文件是否出现在目标目录。

• 额外排查点

  • 检查「Automatic upload」的触发条件是否正确，避免误上传；
  • 执行File > Invalidate Caches...清除缓存后重启PhpStorm，重新配置部署；
  • 确认FTP/SFTP账号对public_html/welcome目录有写入权限。

内容的提问来源于stack exchange，提问作者Jesus Prieto