WebStorm 2025.2 Help

运行/调试配置对话框

分组的运行配置

使用该对话框创建、编辑、调整或移除 run/debug configurations ,以及配置将应用于所有新建 run/debug configurations 的默认模板。

现有的运行/调试配置按配置类型进行分组。 用于创建新配置的模板是 可编辑 的,并可通过对话框左侧窗格中的 编辑配置模板… 链接访问。

通用设置

编辑运行配置(但不是运行配置模板)时,您可以指定以下选项:

项目

描述

名称(N)

为该运行配置指定一个名称,以便在编辑或运行时快速识别。

允许多个实例(U)

允许并行运行该运行配置的多个实例。

默认情况下,该项处于禁用状态。当您在已有一个实例正在运行时启动该配置,WebStorm 会建议停止运行中的实例并启动另一个。这在运行配置占用大量资源且无必要运行多个实例时非常有用。 这在运行配置占用大量资源且无必要运行多个实例时非常有用。

存储为项目文件(S)

保存包含运行配置设置的文件,以与其他团队成员共享。 默认位置为 .idea/runConfigurations 。 但如果您不希望共享 .idea 目录,可以将配置保存到项目内的任意其他目录。

默认情况下,该项处于禁用状态,WebStorm 会将运行配置设置存储在 .idea/workspace.xml 中。

工具栏

运行/调试配置的树状视图包含一个工具栏,帮助您管理 项目 中可用的配置,并调整默认配置模板。

项目

快捷键

描述

添加按钮

Alt+Insert

创建运行/调试配置。

移除按钮

Alt+Delete

删除所选的运行/调试配置。注意,默认配置无法删除。 注意,默认配置无法删除。

复制

Ctrl+D

创建所选运行/调试配置的副本。注意,您也可以复制默认配置。 注意,您也可以复制默认配置。

保存配置

仅在选择 临时配置 时显示此按钮。 点击此按钮可将临时配置保存为永久配置。

移入新文件夹/创建新文件夹

移入新文件夹 / 创建新文件夹。 您可以通过 将运行/调试配置放入文件夹 来进行分组。

要创建文件夹,请选择同一类别下的配置,点击 文件夹 ,并指定文件夹名称。 如果仅聚焦于某一类别,将创建一个空文件夹。

随后要将配置移入文件夹、在文件夹之间移动或从文件夹中移出,请使用拖动,或点击 上移下移 按钮。

若要取消分组,请选择一个文件夹并点击 移除配置

配置排序

点击此按钮可按字母顺序对配置进行排序。

启动前

在此区域,您可以指定在启动所选运行/调试配置之前要执行的任务。 任务将按其在列表中的显示顺序依次执行。

项目

快捷键

描述

添加按钮

Alt+Insert

点击此图标可添加以下可用任务之一:

  • 启动Web 浏览器 :选择此选项可启动浏览器。 在打开的对话框中,选择浏览器类型并提供启动 URL。 还可以指定是否要使用 JavaScript 调试器启动浏览器。

  • 运行外部工具 :选择此项以运行外部应用程序。 在打开的对话框中,选择您要运行的一个或多个应用程序。 如果尚未在 WebStorm 中定义,请添加其定义。 有关更多信息,请参阅 外部工具外部工具

  • 运行另一个配置 :选择此项以执行另一个运行/调试配置,并在其完成后再启动当前配置。 如果您希望并行运行多个配置,请使用 复合运行/调试配置

  • 运行File Watcher :选择此选项可使 WebStorm 应用所有当前激活的 File Watchers

  • 运行远程外部工具 :添加一个 remote SSH external tool

  • 运行Grunt 任务 :选择此选项以运行 Grunt 任务。

    在打开的 Grunt 任务 对话框中,指定定义所需任务的 Gruntfile.js ,选择要执行的任务并指定传递给 Grunt 工具的参数。

    指定 Node.js 解释器的位置、传递给它的参数以及 grunt-cli 包的路径。

  • 运行gulp 任务 :选择此选项以运行 Gulp 任务。

    在打开的 Gulp 任务 对话框中,指定定义所需任务的 Gulpfile.js ,选择要执行的任务并指定传递给 Gulp 工具的参数。

    指定 Node.js 解释器的位置、传递给它的参数以及 gulp 包的路径。

  • 运行npm 脚本 :选择此选项以执行 npm 脚本。

    在打开的 NPM 脚本 对话框中,指定 npm run/debug configuration settings

  • 启动React Native Bundler :选择此选项可在运行或调试会话中自动运行 bundler。 默认情况下,这是通过 react-native start 执行的。

    如果您的应用程序使用 Expo ,则需要通过 start npm 任务运行开发服务器。 为此,请单击 添加 ,然后在 配置 React Native 对话框中,选择 npm 脚本 并从列表中选择 start

  • 编译TypeScript :选择此选项以运行内置 TypeScript 编译器,从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中,选择或取消选择 检查错误 复选框,以在检测到任何错误时配置编译器的行为:

    • 如果选中 检查错误 复选框,编译器将显示所有错误,并且运行配置不会启动。

    • 如果取消选中 检查错误 复选框,编译器将显示所有检测到的错误,但仍会启动运行配置。

  • 生成CoffeeScript 源映射 :选择此选项可为您的 CoffeeScript 源码生成源码映射。 在打开的对话框中,指定您的 CoffeeScript 源文件的位置。

  • 上传文件到远程主机 :选择此选项可根据 default server access configuration ,自动将应用程序文件 上传到服务器

  • 断开数据源 :如果希望在运行/调试配置之前中断与数据源的连接,请选择此选项。

移除按钮

Alt+Delete

单击此图标以从列表中移除所选任务。

编辑

Enter

单击此图标以编辑所选任务。 在打开的对话框中进行必要的更改。

方法上移

方法下移

Alt+Up

Alt+Down

单击这些图标可将所选任务在列表中上移或下移一行。 任务将按照它们在列表中显示的顺序执行。

显示此页面

选择此复选框以在实际启动运行/调试配置之前显示其设置。

激活工具窗口

默认情况下,此复选框为选中状态,并在启动运行/调试配置时打开 RunDebug 工具窗口。

否则,如果未选中该复选框,则工具窗口将被隐藏。 但是,在配置运行时,您可以通过按 Alt+4Alt+5 手动打开相应的工具窗口。

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