PhpStorm 无全自动双向同步，仅支持单向部署；常见上传失败因权限/路径不匹配、排除路径误设、协议选错；自动上传需配置Options并排除敏感文件；Sync仅刷新文件状态而非传输。
PhpStorm 本身不提供“一键同步 FTP”的全自动双向同步功能，它用的是「部署（Deployment）」机制——本质是单向上传/下载 + 手动触发或自动上传，不是像 WinSCP 那样实时镜像。理解这点，才能避免反复踩坑。
为什么 Upload to [server] 没反应或报错？
常见原因不是配置错，而是权限和路径没对齐：
-
Root path在服务器上必须真实存在，且 PhpStorm 有读写权限（比如/var/www/html，但实际你 SSH 登录后ls -ld /var/www/html显示权限为drwxr-xr-x，而 PhpStorm 用户是www-data或其他非 root 用户，就可能上传失败） - 本地项目根目录和远程
Web server root URL不匹配，导致预览时 404，误以为同步失败 - 启用了
Excluded paths（如.idea、node_modules），但误加了src或public，结果关键文件根本没传过去 - FTP 模式选成
FTP却连的是 SFTP 服务（或反之），错误信息常为Connection refused或Authentication failed
如何设置自动上传（Auto Upload）并避免覆盖线上配置？
这是最接近“同步”体验的用法，但必须配合排除规则：
- 打开
Settings → Build, Execution, Deployment → Deployment → Options - 勾选
Upload changed files automatically to the default server，下拉选Always或On explicit save action（推荐后者，更可控） - 关键：进
Mappings标签页，把线上已存在的敏感文件（如wp-config.php、.env、config/database.php）添加到Excluded Paths列表，格式为/path/to/file.php（注意是远程路径） - 如果本地改了
.env又想上传，右键该文件 →Deployment → Upload to [server]，手动传一次即可
Sync with Deployed to [server] 的真实作用是什么？
它不是同步代码，而是同步「文件状态」——即刷新 PhpStorm 里哪些文件在远程已存在、哪些被删了、哪些时间戳不一致。执行后你会看到：
立即学习“PHP免费学习笔记（深入）”；
- 本地有、远程没有的文件变蓝（标记为“新文件”，可上传）
- 远程有、本地没有的文件变红（标记为“缺失”，可下载）
- 内容不同但同名的文件变黄（标记为“冲突”，需手动决定上传 or 下载）
这个操作不会自动执行任何上传/下载，只是更新状态。要真正传输，得再右键 → Upload 或 Download。
遇到 Cannot create file: Permission denied 怎么办？
这不是 PhpStorm 的 bug，而是远端文件系统拒绝写入。优先检查：
- 用终端直接
sftp user@host，尝试put test.txt到同一目录，复现问题 - 确认目标目录属主是否为当前 FTP/SFTP 用户（
ls -ld /path），否则chown user:user /path - 如果用的是 vsftpd，检查
write_enable=YES和local_umask=022是否生效；SFTP 则看sshd_config中ForceCommand internal-sftp是否限制了写权限 - 临时测试：把
Root path改成用户家目录下的子目录（如/home/user/www），通常权限无问题
真正麻烦的从来不是怎么点菜单，而是搞清 FTP/SFTP 账户实际能碰哪些路径、PHP 进程以谁的身份读配置、以及 PhpStorm 的“同步”其实从不自动解决冲突——它只告诉你有冲突。
