WebStorm 2025.2 Help

教程:在 WebStorm 中进行部署

本教程旨在引导您逐步配置并管理使用 WebStorm 将代码部署到远程主机的过程。

配置部署服务器

添加新服务器

  1. 按下 Ctrl+Alt+S 打开设置,然后选择 构建、执行、部署 | 部署

    或者,从主菜单中转到 工具 | 部署 | 配置

  2. 点击 添加项目 并选择要创建的服务器类型。 在本例中为 本地或挂载的文件夹

    添加服务器对话框
  3. 在打开的 创建新服务器 对话框中,输入服务器名称并点击 确定

新服务器已添加,但目前仅显示了 Web 服务器的 URL http://localhost ,您将通过此地址浏览上传的文件。

指定服务器根目录

  1. 文件夹 字段中,指定要上传项目文件的目录。

    在本例中是本地文件夹 Users/jetbrains/deployment 。 您可以手动输入路径,也可以按下 Shift+Enter

  2. 禁用 仅对该项目可见 选项,以便后续可以导出此配置。

    部署连接选项卡

指定部署路径

  1. 接下来,切换到 映射选项卡

    默认情况下, 本地路径 字段包含项目根目录的路径。 不过,您可以选择项目树中的其他任何目录。 我们使用默认路径。

  2. 部署路径 字段(默认情况下为空)中,指定服务器上的文件夹,WebStorm 将从 本地路径 字段中指定的文件夹上传数据到此。

    本例中为 Application 。 此路径是相对于 Web 服务器根目录(即 Users/jetbrains/deployment )指定的。

  3. 保留 Web 路径 的默认 / 值。

应用更改后,服务器即可使用。

浏览远程主机

为确保服务器已启动并运行,请在主菜单中选择 工具 | 部署 | 浏览远程主机 ,此时 WebStorm 窗口右侧将出现 远程主机工具窗口

远程主机工具窗口

部署文件

将文件上传到服务器

首先,将其中一个文件上传到远程服务器。

  1. 项目 工具窗口(Alt+1 )中,右键点击要上传的文件。 在本例中为 README.md 文件。

  2. 在上下文菜单中选择 部署 | 上传到 MyRemoteServer ,确认上传并查看上传结果。

    部署上传

您还可以上传项目中每个目录的内容。 例如,右键点击父目录,然后在上下文菜单中选择 部署 | 上传到 MyRemoteServer。 我们现在已将整个目录上传到服务器。 在 项目 工具窗口中,右键点击要上传的目录并选择 部署 | 上传到 MyRemoteServer

比较远程与本地版本

文件 README.md 同时存在于本地和远程,且内容一致。 请修改本地版本。

  • 远程主机工具窗口 工具窗口中,右键点击 README.md 并选择 与本地版本进行比较。 WebStorm 将打开差异查看器。

    差异查看器

从服务器下载文件

  1. 远程主机工具窗口 工具窗口中,右键点击 README.md 文件并选择 从此处下载。 WebStorm 会显示警告。

    部署下载警告
  2. 点击

    如果该目录之前已上传到服务器,您也可以下载整个目录。

同步更改

  1. Ctrl+Z 撤销对 README.md 文件所做的更改。

  2. 点击 README.md 文件,然后在主菜单中选择 工具 | 部署 | 与 MyRemoteServer 上的部署版本同步

    WebStorm 会显示 Diff 查看器,您可以接受或拒绝各个更改。

    部署同步

自动将文件上传到默认服务器

如果需要确保服务器上的文件与 一个 WebStorm 项目中的文件完全一致,启用自动上传将很有帮助。 自动上传意味着只要 IDE 中发生更改,该更改就会部署到默认部署服务器。

当部署服务器的设置在自动上传变更文件时默认生效,该服务器就被视为默认服务器。

定义默认服务器

  1. Ctrl+Alt+S 打开设置,然后选择 构建、执行、部署 | 部署

    或者,在主菜单中进入 工具 | 部署 | 配置

  2. 在服务器列表中选择要设为默认的服务器,然后点击列表上方工具栏中的 “设为默认”按钮

启用自动上传

设置默认服务器后,您就可以启用自动上传到该服务器。

  1. Ctrl+Alt+S 打开设置,然后选择 部署 | 选项

    或者,在主菜单中进入 工具 | 部署 | 选项

  2. 自动将更改的文件上传到默认服务器 下拉列表中,选择以下选项之一:

    • 始终 :每次自动或显式保存后上传文件。

    • 显式保存操作时 :仅在通过选择 文件(F) | 全部保存(S) 或按下 Ctrl+S 手动保存时上传文件。

不建议在生产部署中使用 始终 模式:开发过程中可能上传不完整的代码,从而破坏生产应用。

上传外部更改

默认情况下,如果文件被一些外部进程更改,例如 VCS 分支更改SASS 或 LESS 编译File Watcher ,WebStorm 也会上传这些文件。 若要更改此行为并跳过外部更改,请将 将更改的文件上传到默认服务器 设置为 始终 ,并选中 跳过外部更改 复选框:

跳过外部更改

导出/导入部署设置

现在,您已设置完部署服务器,可以导出服务器配置设置并在另一台计算机上导入。

将设置导出为 ZIP 存档

  1. 从主菜单中选择 文件(F) | 管理IDE 设置 | 导出设置

  2. 在打开的 导出设置 对话框中,确保选中 WebServers 复选框,并指定目标归档文件的路径。

    导出服务器部署设置

从 ZIP 存档导入设置

  1. 从主菜单中选择 文件(F) | 管理IDE 设置 | 导入设置…

  2. 在打开的对话框中选择包含设置的 ZIP 归档文件。

  3. 在打开的 选择要导入的组件 对话框中选择要应用的设置,然后点击 确定

摘要

您已完成本基础教程并完成以下任务:

  • 创建并配置了自己的服务器。

  • 上传和下载了文件及文件夹。

  • 比较了本地与远程版本。

  • 将服务器设置为默认服务器。

  • 启用了外部更改的自动上传。

最后修改日期: 2025年 9月 26日