WebStorm 2025.2 Help

创建本地服务器配置

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

要在 WebStorm 中创建本地服务器配置,您需要 设置与服务器的连接 ,并 配置 WebStorm 项目与服务器项目文件夹及其对应 URL 路径之间的映射

1. 指定服务器配置的名称、类型和可见性

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

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

  2. 在列出所有现有服务器配置的左侧窗格中,点击 添加 添加项 ,并在弹出菜单中选择 本地或挂载的文件夹

    添加服务器:本地或挂载文件夹
  3. 在打开的 创建新服务器 对话框中,输入要创建的服务器名称,然后点击 确定创建新服务器 对话框关闭,您将返回到 连接 选项卡下的 部署 节点。

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

  5. 清除 仅对此项目可见 复选框,以便在其他项目中重复使用此服务器访问配置。

2. 设置与服务器的连接

连接 选项卡(Ctrl+Alt+S| 构建、执行、部署 | 部署 )中,指定服务器设置:

  • 文件夹 :指定服务器配置文件中定义的服务器文档根目录的绝对路径。 除了文档根目录本身之外,还可以指定其下的任何其他现有文件夹。

    文档根目录是 Web 服务器将文件提供到 Web 服务器 URL 的文件夹。

  • Web 服务器 URL :在服务器配置文件中映射到服务器文档根目录的 URL 地址(主机名和(可选)端口)。 这是应用程序访问地址的基本 URL。 支持 HTTPHTTPS

    点击字段右侧的 浏览 以打开并检查所提供的 Web 服务器 URL。

指定服务器配置根目录和用于访问的 URL 地址

3. 将项目文件夹映射到服务器文件夹和 URL 路径

映射 选项卡(Ctrl+Alt+S| 构建、执行、部署 | 部署 )中,指定 WebStorm 中打开的项目与服务器文档根目录中的相应文件夹之间的映射关系:

将项目文件夹映射到服务器文件夹及其访问 URL 地址
  • 本地路径 :本地项目文件夹的绝对路径。 WebStorm 会自动填充此字段为当前打开项目的路径。

  • 部署路径 :位于服务器文档根目录下的文件夹,WebStorm 会将 本地路径 字段中指定的项目文件夹内容上传到此处。

    如果服务器上尚不存在具有指定名称的文件夹,当您触发 project upload 时,WebStorm 将会创建它。

    最简单的方法是将整个项目根文件夹映射到服务器文档根目录下的某个文件夹。 在这种情况下,项目文件夹结构将在服务器上重新创建。

  • Web 路径 :为 部署路径 中指定的文件夹配置的 URL 路径。 您可以使用斜杠(/ )指向根文件夹,或者在目录无法通过 Web 访问时将该字段留空。

现在,您已添加服务器配置,可以在 Remote Host tool window 中访问服务器的文件和文件夹。 在主菜单中转到 工具 | 部署 | 浏览远程主机 ,在打开的工具窗口中,从下拉列表中选择已配置的服务器。

打开“远程主机”工具窗口并选择服务器
最后修改日期: 2025年 9月 26日