WebStorm 2025.2 Help

Web 浏览器及预览

在此页面,您可以配置以下内容:

  • 将 Web 浏览器安装集成到 WebStorm 中,启用或禁用。

  • 指定是通过运行浏览器的可执行文件还是通过系统默认命令来启动浏览器。

  • 指定 默认的 WebStorm 浏览器 ,WebStorm 将默认在其中 打开 HTML 文件 ,即在未明确指定浏览器时。

  • 启用在浏览器中打开 HTML 或 XML 文件的浏览器弹出窗口。

  • 配置页面应何时在浏览器或内置预览中自动重新加载。

了解详细信息,请参阅 配置浏览器

浏览器

在此部分中,指定哪些浏览器可用于预览 HTML 输出。 该部分显示预定义列表中的浏览器以及之前配置的自定义浏览器安装(如果有)。

WebStorm 附带一份预定义的主流浏览器列表,您可以在运行、调试或 预览 HTML 文件输出 时从 IDE 中安装并自动启动这些浏览器。 WebStorm 假定您按照标准安装程序安装浏览器,并为每个安装分配一个 别名 ,用于表示浏览器可执行文件或 macOS 应用程序的默认路径。

如果您实际安装的浏览器中的可执行文件路径不同,则需要在 路径 字段中明确指定。

除了预定义浏览器,您还可以使用工具栏上的控件配置任意数量的自定义浏览器安装。

项目

说明

启用

选中此复选框,以在 WebStorm 中启用相应浏览器。 此浏览器将添加到 在浏览器中打开 菜单项的上下文菜单中,并在浏览器图标弹出窗口中显示图标。 请参阅 配置浏览器图标弹出窗口 ,了解如何在编辑器中隐藏和显示弹出窗口。

如果未选中此复选框,相应的浏览器图标将不会显示在图标工具栏或弹出窗口中。

名称

在此列中,指定浏览器名称。

系列

在此列中,指定浏览器所属的系列。

路径

在此列中,指定可执行文件的路径。 如果浏览器是按照标准安装步骤安装的,通常 别名路径 字段中会指向正确位置。 如果不是,请单击 浏览按钮 并在打开的对话框中选择实际路径。 在打开的对话框中,选择所选浏览器的可执行文件路径。

工具栏

项目

说明

添加按钮

单击此按钮将自定义浏览器添加到列表中。

移除按钮

单击此按钮可将所选的自定义浏览器从列表中删除。请注意,无法删除预定义列表中的浏览器。 请注意,无法删除预定义列表中的浏览器。

编辑按钮

单击此按钮为 FirefoxChrome 系列浏览器指定自定义配置文件。 仅当选中了 FirefoxChrome 时,该按钮才可用。

Firefox 设置 对话框中,指定用于预览输出的 Firefox 浏览器配置文件

  • “profiles.ini” 路径 :在此字段中,指定包含 profiles.ini 文件的路径,该文件确定要使用的 Firefox 配置文件。

  • 配置文件 :从此列表中选择所需的预定义配置文件。 更多信息请参见 Firefox 浏览器配置文件

Chrome 设置 对话框中:

  • 命令行选项 :在此字段中,输入用于启动一个 Chrome 实例的命令行选项。 若需更多空间,请单击 展开图标 ,或按 Shift+Enter 打开编辑器框。 通过在 Chrome 中打开 chrome://flags 了解有关 Chrome 命令行选项的更多信息。

  • 使用自定义用户数据目录 :选中此复选框以定义要使用的特定用户 Chrome 配置文件设置,并在 WebStorm 设置中指定 用户数据目录 的位置。

上一处按钮 下一处按钮

使用这些按钮在列表中上移或下移所选浏览器。 浏览器的顺序对于渲染外部资源和预览包含 Web 内容的文件很重要。

复制按钮

单击此按钮可创建所选浏览器的副本。

默认浏览器

在此部分,指定用于渲染外部资源和预览包含 Web 内容的文件的 默认 WebStorm 浏览器。 当您从主菜单中选择 视图 | 在浏览器中打开 或从文件的上下文菜单中选择 在浏览器中打开 时,在上下文菜单中该浏览器将被标记为 默认

项目

描述

默认浏览器

从列表中选择默认浏览器。 可选项包括:

  • 系统默认 :选择此选项可将操作系统默认 Web 浏览器作为 WebStorm 的默认浏览器。

  • 首个列出项 :选择此选项可使 WebStorm 启动列表中的第一个浏览器。 使用工具栏上的 上一处按钮下一处按钮 图标更改浏览器顺序。

  • 自定义路径 :选择此选项可将其他 Web 浏览器设置为 WebStorm 的默认浏览器。 输入浏览器可执行文件的路径,或单击 浏览按钮 并在打开的对话框中选择路径。

在编辑器中配置浏览器图标弹出窗口

在此区域配置是否希望 WebStorm 在 HTML 或 XML 文件中显示已启用浏览器的弹出窗口。 此弹出窗口用于 预览当前文件的输出

默认情况下,浏览器图标弹出窗口仅在 HTML 文件中出现。 在 XML 文件中,为避免干扰阅读或编辑代码,默认不会显示弹出窗口。 使用 适用于 HTML 文件适用于 XML 文件 复选框可根据当前文件类型控制是否显示弹出窗口。

重新加载行为

在此区域中,指定触发在浏览器或内置预览中自动重新加载 HTML 页面的操作。 详细了解,请参阅 在浏览器中预览 HTML 文件

在浏览器中重新加载页面在内置预览中重新加载页面 列表中选择将触发页面在 Web 浏览器和内置预览中自动重新加载的操作。

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

    保存时重新加载 HTML 页面

    当您保存触发页面重新加载的文件时,WebStorm 会显示 明白了 工具提示。

    保存时重新加载提示:我知道了
  • 如果选择 更改时 ,则在输入内容时页面会自动重新加载。

    内置预览:更改时重新加载预览
  • 要禁止页面自动重新加载,请选择 已禁用

内置服务器

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

详细了解,请参阅 调试在内置服务器上运行的应用程序

项目

描述

端口

使用此微调框指定内置 Web 服务器运行的端口。 默认情况下,该端口设置为 63342 ,WebStorm 通过该端口接收来自服务的连接。 您可以将端口号设置为任何从 1024 起的值。

可接受外部连接(E)

如果选中此复选框,则运行在指定端口上的内置服务器上的文件可从其他计算机访问。

如果取消选中此复选框(默认为取消选中),则调试器仅监听本地连接。

允许未签名的请求(A)

出于安全考虑,默认情况下,任何来自 WebStorm 外部对内置服务器页面的请求都会被拒绝,并会显示 页面 404

要允许访问请求的页面,请选中 允许未签名请求 复选框。

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