WebStorm 2025.2 Help

连接到 Web 服务器

WebStorm 区分以下三种 “本地开发 — 部署服务器” 配置:

  • 就地服务器配置。

    在就地服务器配置中,您使用的是 本地 Web 服务器 ,但与 本地服务器配置 不同,不会在 WebStorm 项目 与服务器文件结构中的项目文件夹之间上传/下载或同步文件。 相反,您将在 WebStorm 中直接从服务器文档根目录打开项目文件夹,从而直接在服务器上进行开发。

    创建就地服务器配置

  • 本地服务器配置。

    本地服务器 是在本地或挂载文件夹中运行并将文件服务到本地 URL 地址的服务器。 在本地服务器配置中,您在 WebStorm 项目 中进行开发,然后将项目文件上传到服务器上的 文档根目录

    创建本地服务器配置

  • 远程服务器配置。

    远程服务器 配置中,服务器在另一台计算机(远程主机)上运行。 要访问远程服务器上的文件,请使用 FTP/SFTP/FTPS/WebDAV 协议。

    创建远程服务器配置

开始之前

通过默认启用的 FTP/SFTP/WebDAV Connectivity 捆绑插件提供与服务器的同步、文件上传、下载和管理功能。 如果该插件被禁用,请在 插件 页的 设置 对话框中启用。 有关详细信息,请参见 安装插件

请确保 Web 服务器已配置并正在运行。 有关详细信息,请参考 Web 服务器官方文档。

您可以根据需要定义任意数量的配置,从而灵活切换上传/下载设置。

如果需要将代码部署到多个服务器,可以创建 服务器组 ,从而避免单独部署到每个服务器。

服务器访问配置

WebStorm 通过 服务器访问配置 控制与服务器的交互。 每次使用服务器之前,都需要定义服务器访问配置,无论您的服务器是在远程主机上还是本机上。

服务器访问配置 定义以下内容:

  • 服务器类型(就地本地远程)。

  • 服务器运行的计算机(主机)。 对于 就地本地 服务器,WebStorm 假定服务器运行在当前项目所在的计算机上。

  • 服务器访问配置根目录 :可通过服务器配置访问的服务器层级结构中的最高文件夹。

  • 访问 服务器配置根目录 的 URL 地址。

  • 用于传输数据的协议及连接参数。

  • 本地文件夹(即项目根目录下的文件夹)、服务器上的目标文件夹(无论是本地还是远程)以及用于访问服务器上数据的 URL 地址之间的对应关系。 此对应关系称为 映射

    例如,您的项目存储在 C:/Projects/My_Project/ 下,并包含一个文件夹 C:/Projects/My_Project/My_Folder ,而本地服务器的文档根目录位于 C:/xampp/htdocs 。 您将整个项目树上传到 C:/xampp/htdocs/My_Project 。 在 WebStorm 中, C:/Projects/My_Project/My_Folder 文件夹称为 本地 C:/xampp/htdocs/My_Project/My_Folder 文件夹称为 远程

您可以根据需要定义任意数量的配置,从而灵活切换上传/下载设置。

如果需要将代码部署到多个服务器,可以创建 服务器组 ,从而避免单独部署到每个服务器。

默认服务器访问配置

您可以将服务器配置设置为 默认 ,以便在以下情况下 WebStorm 自动应用该配置:

  1. 设置 对话框(Ctrl+Alt+S )中,前往 构建、执行、部署| 部署 ,在中间窗格中选择所需的服务器访问配置,然后点击工具栏上的 “设为默认”按钮

    或者,点击 WebStorm 状态栏中的 默认部署服务器 小部件,并从弹出菜单中选择所需的服务器或服务器组。

    在 WebStorm 状态栏中选择默认部署服务器
  2. 配置上传到默认服务器 ,请前往 构建、执行、部署| 部署| 选项

服务器访问配置的可见性

服务器访问配置设置完成后,可在所有现有 WebStorm 项目中使用。 您可以将配置的使用限制为当前项目。

  1. 设置 对话框(Ctrl+Alt+S )中,转到 构建、执行、部署| 部署 ,然后在中间窗格中选择所需的服务器访问配置。

  2. 使用 仅对此项目可见 复选框可启用在其他项目中重复使用此服务器访问配置。

    • 选中复选框以将该配置的使用限制为当前项目。此配置无法在当前项目之外复用。它不会出现在其他项目可用配置的列表中。 此配置无法在当前项目之外复用。 它不会出现在其他项目可用配置的列表中。

      服务器配置设置与项目一起存储在 .idea 目录中,从而可以 通过 VCS 在团队成员之间共享。

      在左侧窗格的服务器访问配置列表中,仅在当前项目中可见的配置会以 仅在当前项目中可见图标 图标标记。

    • 清除复选框时,所有 WebStorm 项目中都可见该配置。 其设置可在多个项目之间复用。

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