WebStorm 2025.2 Help

运行/调试配置:附加到 Node.js/Chrome

创建: 运行(U) | 编辑配置(E) | 添加新配置| 附加到 Node.js/Chrome

本页介绍了特定于配置的项目,以及所有运行/调试配置通用的 选项。 如需有关此配置使用的更多信息,请参见 调试正在运行的 Node.js 应用程序

在此对话框中,创建用于调试已在运行的 Node.js 应用程序的配置。 此方法使您能够在不重新启动 Node.js 服务器的情况下重新启动调试会话。

也可使用此配置调试 NW.js 应用程序的后台进程和其他 进程,请参见 运行/调试配置:NW.js

通过此配置,您还可以 调试 Chrome 扩展

开始之前

下载并安装 Node.js

特定的附加到 Node.js/Chrome 配置设置

项目

描述

主机

在此字段中,指定应用程序正在运行的主机。

端口

在此字段中,指定启动 Node.js 进程时传递给 --inspect--inspect-brk--debug 的端口号,以便建立连接。 从内置的 终端 中的信息提示 调试器正在监听... 或用于控制正在运行应用程序的 Run 工具窗口中复制此端口号。

从 Run 工具窗口或 Terminal 开始调试:信息提示

自动重新连接

选中此复选框以启用 WebStorm 内置调试器,在应用程序代码发生更改后重新附加到正在运行的 Node.js 进程。 这使您能够调试使用 nodemon 实用程序 的 Node.js 应用程序,该实用程序会在代码更新时自动重新加载 Node.js 进程。 如需更多信息,请参见 调试使用 nodemon 的应用程序

本地文件的远程 URL

在此区域,指定项目文件夹的远程路径。 如果正在运行的应用程序根文件夹名称与您的 WebStorm 项目根文件夹名称不同,此操作将非常有用。 在下方示例中,WebStorm 项目的根文件夹 /Users/WsProjects/express 映射到服务器上的 /usr/src/app

指定本地文件的远程 URL

通用设置

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

项目

描述

名称(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

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

  • 运行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

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

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

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

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

移除按钮

Alt+Delete

点击该图标可从列表中移除所选任务。

编辑

Enter

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

方法上移

方法下移

Alt+Up

Alt+Down

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

显示此页面

选中该复选框,即可在实际启动运行/调试配置前显示其设置。

激活工具窗口

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

否则,如果清除此复选框,将隐藏该工具窗口。 但是,当配置正在运行时,您可以通过按下 Alt+4Alt+5 来手动打开其相应的工具窗口。

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