WebStorm 2026.3 Help

连接到 Web 服务器

根据要访问文件的位置选择部署配置:

  • 就地服务器配置。

    在就地服务器配置中,可直接在 WebStorm 中,从现有 本地 Web 服务器的文档根目录打开项目文件夹。 该配置会将项目文件映射到 URL,服务器会直接使用这些文件。 与 本地服务器配置不同,无需在 WebStorm 项目与服务器文件结构中的单独文件夹之间上传、下载或同步文件。

    创建就地服务器配置

  • 本地服务器配置。

    本地服务器通过本地 URL 从本地或已挂载文件夹提供文件。 在本地服务器配置中,在 WebStorm 项目中开发应用程序,然后将项目文件上传到服务器的 文档根目录 ,即服务器提供文件的文件夹。

    创建本地服务器配置

  • 远程服务器配置。

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

    创建远程服务器配置

开始之前

文件传输使用捆绑的 FTP/SFTP/WebDAV 连接性 插件。 如果缺少部署操作,请打开 设置 | 插件 | 已安装 并启用该插件。

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

为不同目标创建单独的配置。 每个配置都有自己的连接设置,以及项目文件夹与目标文件夹之间的映射。

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

服务器访问配置

部署配置会存储用于访问文件的连接设置和文件夹映射。 它不会安装或启动服务器软件。

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

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

  • 用于 FTP、FTPS、SFTP 或 WebDAV 连接的远程主机。 就地配置以及本地或已挂载文件夹配置使用可从运行 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 目录中。 在 通过版本控制共享这些文件之前,请检查这些文件。 可用于所有项目的服务器配置存储在 IDE 设置中。

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

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

2026年 11月 6日