根本原因是Deployment未启用自动上传或文件不在映射路径内；需检查Options中“Upload changed files automatically”是否勾选、Default server是否正确，并确认Mappings中Local path与Deployment path配置准确无误。
为什么保存文件后 SFTP 没自动上传？
根本原因只有两个：Deployment 未启用自动上传，或当前文件不在已配置的映射路径内。PhpStorm 不会监听整个项目目录，只对 Mappings 表格中明确列出的 Local path 生效。
检查以下三点：
-
Settings > Build, Execution, Deployment > Deployment > Options中，确认勾选了Upload changed files automatically to the default server，且下拉框选的是你配好的服务器名（不是“None”） - 打开
Deployment > Configuration > Mappings，确认当前编辑的文件路径能被某一行的Local path完全覆盖（例如你改的是src/Controller/UserController.php，但映射只设了public/，那它就不会上传） - 如果配了多个服务器，必须在左侧服务器列表里点击目标项，再点
Use this server as default—— 否则自动上传逻辑直接跳过
如何正确设置 SFTP 映射路径（Root path 和 Deployment path 的关系）
上传错目录、连接成功但文件消失、Permission denied，90% 出在这一步。关键不是“连上”，而是“放对地方”。
Root path 是远程服务器上的绝对起点，比如 /var/www/html；它不能是 ~、不能为空、也不能带用户名前缀。而 Deployment path 是相对于 Root path 的子路径，比如填 /app，最终上传位置就是 /var/www/html/app。
常见错误配置：
-
Root path填成/var/www/html/myproject，Deployment path又填/myproject→ 实际上传到/var/www/html/myproject/myproject/，多了一层 -
Local path填了./（项目根），但Deployment path填了/→ 整个项目覆盖Root path目录，可能删掉vendor/或.env - 用宝塔时
Root path填了网站根目录（如/www/wwwroot/example.com），但没确认该目录属主是否为 SSH 登录用户（否则上传后 PHP 进程读不到）
上传成功但网页不更新？先查 opcache 和文件权限
这不是 PhpStorm 的同步问题，而是服务器端缓存或权限导致的假性“不同步”。尤其在宝塔、LNMP 环境下高频出现。
典型现象：文件明明显示已上传，curl -s http://yoursite.com/test.php 却返回旧内容，或报 500 Internal Server Error。
立即排查：
- 登录服务器，运行
php -i | grep opcache.enable，若输出opcache.enable => On，需进宝塔 PHP 设置里禁用 opcache，或加临时配置opcache.revalidate_freq=0 - 检查上传后文件权限：
ls -l /var/www/html/index.php，确认属主是 web 服务运行用户（如www-data或nobody），而不是 SSH 用户；否则 PHP 进程无权读取 - 某些共享主机禁止
chmod，上传后需手动执行chmod 644 *.php，否则文件虽存在却无法执行
中文文件名上传失败或乱码怎么办？
FTP/SFTP 协议本身不强制编码，而 PhpStorm 默认按系统 locale 解释文件名。Linux 服务器通常用 UTF-8，Windows 本地可能是 GBK，一来一回就出问题。
解决方式很直接：
- 所有文件名、目录名统一用英文（这是最稳妥的做法，也符合部署规范）
- 如必须支持中文，确保服务器 SSH 配置中启用了 UTF-8：检查
/etc/default/locale是否含LANG="en_US.UTF-8"，并确认终端登录后locale输出一致 - PhpStorm 内不要依赖“自动检测编码”，在
Settings > Editor > File Encodings中把Global Encoding和Project Encoding都设为UTF-8，并勾选Transparent native-to-ascii conversion
真正容易被忽略的是：SFTP 自动上传只管文件内容和路径，不管 Web 服务器能否解析这个路径里的中文字符——Nginx/Apache 若未显式配置 charset utf-8，即使上传成功，请求也会 404 或乱码。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
