你想知道在 PHPStorm 中配置完服务器后,如何设置代码自动上传 / 同步到服务器,这是提升开发效率的核心配置之一。下面我会一步步教你完成设置,非常直观。
前提条件
在设置自动上传前,你需要先完成:
已在 PHPStorm 的「Settings/Preferences → Build, Execution, Deployment → Deployment」中添加了服务器配置(FTP/SFTP/ 本地服务器等);
确保服务器配置的「Connection」和「Mappings」(路径映射)都测试通过(点击「Test Connection」显示成功)。
步骤 1:开启自动上传的核心设置
打开 PHPStorm,点击顶部菜单栏的「File」(Windows/Linux)或「PHPStorm」(Mac) → 「Settings/Preferences」(快捷键:Ctrl+Alt+S / Cmd+,);
在设置面板中,找到「Build, Execution, Deployment → Deployment」;
在右侧面板中,先勾选顶部的「Automatic upload (always)」(自动上传,始终),这是开启自动上传的核心开关:
可选:如果不想 “始终” 上传,也可以选「Automatic upload (on explicit save)」(仅手动保存时上传),更灵活;
额外推荐勾选「Delete remote files when local files are deleted」(删除本地文件时同步删除服务器文件),保持两端文件一致;
(文字描述:该选项在 Deployment 设置的右侧顶部,勾选后即开启自动上传)
步骤 2:确认 “默认服务器”(关键!避免上传到错误服务器)
还是在「Deployment」设置页面,点击左侧的「Options」(选项);
在「Upload/download project files to/from」下拉框中,选择你之前配置好的服务器名称(比如 “LocalServer” 或 “RemoteSFTP”);
这样 PHPStorm 就知道要把代码自动上传到哪个服务器了。
步骤 3:测试自动上传效果
在本地项目中修改一个文件(比如index.php),保存(Ctrl+S / Cmd+S);
打开 PHPStorm 底部的「Deployment」工具窗口(如果没显示,点击「View → Tool Windows → Deployment」);
可以看到日志中会显示 “Uploading [文件名] to [服务器名称]”,说明自动上传成功;
登录你的服务器(或打开本地服务器的目录),查看对应文件,会发现已经同步了修改后的内容。
补充:其他实用配置(可选)
排除不需要上传的文件:
如果有一些本地文件(如node_modules/、.git/、vendor/)不想上传,可在「Deployment → Options」中,找到「Excluded files」,添加需要排除的文件 / 目录规则(比如*.log、node_modules/);
手动触发上传 / 下载:
即使开了自动上传,也可以右键点击文件 / 目录 → 「Deployment → Upload to [服务器名]」(手动上传),或「Download from [服务器名]」(从服务器下载);
自动上传的时机说明:
勾选「always」:修改文件后,即使只是自动保存(PHPStorm 默认 10 秒自动保存),也会触发上传;
勾选「on explicit save」:只有你手动按Ctrl+S保存时,才会上传,适合需要先写完一段代码再同步的场景。
常见问题排查
如果自动上传没生效:
检查「Mappings」路径映射是否正确(本地路径 ↔ 服务器路径必须对应);
确认服务器的「Connection」测试成功(没连上网 / 服务器密码错误都会导致上传失败);
查看 PHPStorm 右下角的提示(上传失败会有红色警告,鼠标悬停可看原因)。
总结
开启自动上传的核心是勾选「Automatic upload (always)」,并设置默认服务器;
路径映射(Mappings)必须正确,否则会上传到服务器的错误目录;
可通过「Deployment」工具窗口查看上传日志,排查失败原因。
这样配置后,你本地写的代码只要保存,就会自动同步到服务器,不用再手动复制文件,开发时直接访问服务器地址就能看到最新效果了。