WebStorm 2025.2 Help

配置浏览器

WebStorm 随附一个预定义的主流浏览器列表,您可以在运行、调试或 预览 HTML 文件的输出 时,从 IDE 自动启动这些浏览器。 WebStorm 假设您按照标准步骤安装浏览器,并为每次安装分配一个 alias ,该 alias 表示浏览器可执行文件或 macOS 应用程序的默认路径。 除了默认列表中的浏览器之外,您还可以配置自定义浏览器安装。

WebStorm 包含一个内置 Web 服务器,可用于在 Web 浏览器中调试应用程序或在 WebStorm 内置浏览器中预览代码。 该服务器始终运行,无需任何手动配置。

默认情况下,内置服务器端口设置为 63342 ,WebStorm 通过此端口接受来自服务的连接。 若要更改此默认值,请打开 设置 对话框(Ctrl+Alt+S ),转到 工具 | Web 浏览器和预览 ,并在 内置服务器 部分中指定从 1024 开始的任意其他值。

  1. Ctrl+Alt+S 打开设置,然后选择 工具 | Web 浏览器和预览

  2. 打开的 Web 浏览器及预览 页面显示了预定义列表中的浏览器以及之前已配置的自定义浏览器安装(如果有)。 对于每个浏览器,WebStorm 会显示其名称、所属系列,以及可执行文件或 macOS 应用程序的路径,或表示该路径的预定义 alias

  3. 要启用某个浏览器,请选中其名称旁边的复选框。 该浏览器将添加到 在浏览器中打开 菜单项的上下文菜单中,其图标将显示在浏览器图标弹出窗口中。 请参阅 配置浏览器图标弹出窗口 ,了解如何在编辑器中隐藏和显示此弹出窗口。

    如果浏览器是按照标准安装流程安装的, 路径 字段中的 别名 很可能指向正确的位置。 如果不是,请单击 浏览按钮 ,在打开的对话框中选择实际路径。

当您选择 视图 | 在浏览器中打开 、或按 Alt+F2 、或调用浏览器图标栏时,可用浏览器会按照它们在 Web 浏览器和预览 页面中的排列顺序显示。 如需更改列表中浏览器的顺序,请使用 上移下移 按钮。

配置自定义浏览器

  1. Ctrl+Alt+S 打开设置,然后选择 工具 | Web 浏览器和预览

  2. 单击工具栏上的 添加按钮 ,在新行中指定浏览器名称、所属系列以及其可执行文件或 macOS 应用程序的路径。

使用自定义配置文件

对于 Firefox 和 Chrome 系列浏览器,您可以使用自定义配置文件。

  • Web 浏览器和预览 页面中,选择浏览器并单击工具栏上的 。 根据所选浏览器的系列,将打开 Firefox 设置Chrome 设置 对话框。

    • 对于 Firefox ,请指定所需 profiles.ini 文件的路径,并从列表中选择要使用的配置文件。 请参阅 Firefox browser profile 了解更多信息。

    • 对于 Chrome ,请勾选 使用自定义用户数据目录 复选框,并在 WebStorm 设置中指定 user data directory 的位置。

    • 要使用附加选项启动 Chrome 系列的浏览器,请在工具栏上点击 ,并在打开的 Chrome 设置 对话框的 命令行选项 字段中输入所需的参数。 如需了解 Chrome 命令行选项,请在 Chrome 中打开 chrome://flags

从列表中移除浏览器

选择所需浏览器并点击工具栏上的 。 请注意,仅可移除自定义浏览器。

    选择默认 WebStorm 浏览器

    若要通过主菜单中的 视图 | 在浏览器中打开 或文件的上下文菜单中的 在浏览器中打开 在浏览器中预览应用程序输出,您需要选择用于打开预览的浏览器。 您可以在上下文菜单中使用特定浏览器,也可以选择 默认浏览器

    WebStorm 还会打开 WebStorm 默认浏览器 来渲染外部资源。

    1. Ctrl+Alt+S 打开设置,然后选择 工具 | Web 浏览器和预览

    2. 默认浏览器 列表中选择默认用于预览页面的浏览器。

      • 若要使用默认操作系统浏览器,请选择 系统默认

      • 若要使用列表顶部的浏览器,请选择 列表中第一个。 使用工具栏上的 上移下移 图标更改浏览器顺序。

      • 如需将其他浏览器设置为默认浏览器,请选择 自定义路径 并指定所需浏览器的可执行文件位置。 可以手动输入路径,或者在需要时使用 浏览 浏览按钮

    配置浏览器图标弹出窗口

    默认情况下,浏览器图标弹窗仅在 HTML 文件中显示。 在 XML 文件中,为了帮助您专注于代码的阅读与编辑,默认情况下不会显示此弹窗。

    • 要设置是否在 HTML 或 XML 文件中显示弹窗,请转到 工具 | Web 浏览器和预览 设置页面 Ctrl+Alt+S ,然后在 在编辑器中显示浏览器弹出窗口 区域使用 适用于 HTML 文件适用于 XML 文件 复选框。

    • 如果您将弹窗设置为在 HTML 或 XML 文件中隐藏,可以使用主菜单中的 视图 | 在浏览器中打开 命令或文件上下文菜单中的 在浏览器中打开 命令预览相应类型的文件。

    配置 HTML 页的自动重新加载

    默认情况下,当您在浏览器或内置预览中打开 HTML 文件后,每次手动或自动保存此 HTML 文件(或任何关联的 JavaScript 或样式表文件)时,WebStorm 都会自动重新加载页面,参见 保存并还原更改

    您可以更改默认行为,使其在输入时重新加载页面,从而使对 HTML 或相关文件的更改能够立即在浏览器或内置预览中显示出来。

    1. 转到 工具 | Web 浏览器和预览 设置页面 Ctrl+Alt+S。 或者,点击 配置 ,该图标位于 知道了! 工具提示中。

    2. 重新加载行为 区域,从 在浏览器中重新加载页面在内置预览中重新加载页面 列表中选择将在 Web 浏览器和内置预览中触发页面自动重新加载的操作。 默认选中 保存时

      • 选择 更改时 ,当您更新相应的 HTML 文件或相关文件时重新加载页面。

      • 选择 已禁用 以禁止自动上传。

    如需详细了解,请参阅 配置自动重新加载

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