WebStorm 2025.3 Help

连接到 Web 服务器

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

  • 就地服务器配置。

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

    创建就地服务器配置

  • 本地服务器配置。

    本地服务器 是在本地或已挂载文件夹中运行,并向本地 URL 地址提供文件的服务器。 在本地服务器配置中,您在一个 WebStorm project 中进行开发,然后将项目文件上传到服务器上的 document root

    创建本地服务器配置

  • 远程服务器配置。

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

    创建远程服务器配置

开始之前

通过默认启用的 FTP/SFTP/WebDAV Connectivity捆绑插件提供与服务器的同步、文件上传、下载及管理功能。 如果插件被禁用,请在 插件 页面的 设置 对话框中激活它。 如需更多信息,请参阅 安装插件

确保 Web 服务器已配置并正在运行。 有关更多信息,请参阅 Web 服务器的官方文档。

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

如果需要将代码部署到多个服务器,可以创建 服务器组 ,避免分别部署到每台服务器。

服务器访问配置

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

一份 服务器访问配置定义如下内容:

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

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

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

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

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

  • 本地文件夹(即项目根目录下的文件夹)、服务器上的目标文件夹(本地或远程)与访问服务器数据的网址地址之间的对应关系。 这种对应关系称为 mapping

    例如,您的项目存储在 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 文件夹被称为 local ,而 C:/xampp/htdocs/My_Project/My_Folder 文件夹被称为 remote

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

如果需要将代码部署到多个服务器,可以创建 服务器组 ,避免分别部署到每台服务器。

默认服务器访问配置

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

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

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

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

服务器访问配置的可见性

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

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

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

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

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

      在左侧面板的服务器访问配置列表中,当前项目中仅可见的配置标有 仅在当前项目中可见的图标 图标。

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

最后修改日期: 2025年 12月 8日