WebStorm 2025.2 Help

运行/调试配置:Spy-js for Node.js

创建: 运行(U)| 编辑配置(E)| 添加新配置|Node.js 的 Spy-js

本页面介绍了特定于配置的项目以及所有运行/调试配置通用的 选项。 如需详细了解如何使用此配置,请参见 使用 Spy-js 对 JavaScript 进行性能分析

在此对话框中,创建用于使用 Spy-js 工具 跟踪 Node.js 应用的配置。

开始之前

  1. 下载并安装 Node.js

  2. 请确保在 设置|插件 页的 已安装 选项卡中启用了 Node.js 内置插件,具体说明请参见 安装插件

  3. 设置|插件 页的 插件市场 选项卡中安装 Spy-js 插件,具体说明请参见 从 JetBrains Marketplace 安装插件

Spy-js for Node.js 专用配置设置

项目

描述

Node 解释器

在此字段中,指定要使用的 Node.js 解释器。

如果选择 项目 别名,WebStorm 会自动使用 Node.js 页中 Node 解释器 字段的项目默认解释器。 在大多数情况下,WebStorm 会检测项目默认解释器并自动填写该字段。

您还可以选择其他已配置的本地或远程解释器,也可以单击 浏览按钮 以配置新的解释器。

如需了解更多信息,请参见 配置远程 Node.js 解释器配置本地 Node.js 解释器在 Windows 子系统 Linux 中使用 Node.js

建议在使用 Spy-js 时采用版本为 0.10.24 或更高版本的 Node.js。

如需启用对 ECMAScript 6 脚本的跟踪,请使用版本为 0.11.13 或更高的 Node.js,并在 Node 参数中指定 --harmony

Node 参数

在此字段中,输入要传递给 Node.js 可执行文件的特定于 Node.js 的命令行选项。 例如,如需启用对 ECMAScript 6 脚本的跟踪,请将 --harmony 指定为 Node 参数。 请注意,Node.js 必须为 0.11.13 或更高版本。

工作目录

在此字段中,指定应用的工作目录。 默认情况下, 工作目录 字段显示项目根文件夹。 如需更改该预定义设置,请指定目标文件夹的路径。

JavaScript 文件

在此字段中,指定启动应用的主文件路径(例如,对于 Express 应用,填写 bin/www )。

如果要跟踪 CoffeeScript,请指定已生成的 JavaScript 文件路径。 该文件可以通过外部方式生成,或通过使用 File Watcher 编译方式生成。 如需获取详细信息,请参见 调试 CoffeeScript

应用参数

在此字段中,输入要通过 process.argv 数组在启动时传递给应用的特定于 Node.js 的参数。

环境变量

在此字段中指定 Node.js 可执行文件的 环境变量 (如适用)。 点击 浏览 浏览按钮 (位于字段右侧),并在打开的 环境变量 对话框中配置变量列表:

  • 要定义新变量,请点击 添加按钮 ,然后指定变量名称和值。

  • 要放弃变量定义,请在列表中选择该变量并点击 移除按钮

  • 准备就绪后,点击 确定

变量定义显示在 环境变量 只读字段中,各变量之间以分号分隔,例如:

  • NODE_PATH :由 : 分隔的目录列表,作为模块搜索路径的前缀。

  • NODE_MODULE_CONTEXTS :设为 1 以在各自的全局上下文中加载模块。

  • NODE_DISABLE_COLORS :设为 1 以禁用 REPL 中的颜色。

配置文件

从此列表中选择要应用于跟踪会话的配置设置文件。

配置文件 是扩展名为 .js .conf.js 的 JavaScript 文件,包含符合 Spy-js 配置要求 的有效 JavaScript 代码。 如果 WebStorm 检测到项目中存在扩展名为 .conf.js 的文件,这些文件将显示在列表中。

手动输入配置文件路径,或点击 浏览 浏览按钮 并在打开的对话框中选择位置。 配置文件指定后会添加到列表中,便于下次直接从列表中选择,而无需重新指定路径。

通用设置

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

项目

描述

名称(N)

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

允许多个实例(U)

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

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

存储为项目文件(S)

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

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

工具栏

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

项目

快捷键

描述

添加按钮

Alt+Insert

创建一个运行/调试配置。

移除按钮

Alt+Delete

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

复制

Ctrl+D

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

保存配置

仅当您选择 临时配置 时才会显示此按钮。 点击该按钮可将临时配置保存为永久配置。

移动到新文件夹/创建新文件夹

移动到新文件夹/创建新文件夹。 您可以通过 将其放入文件夹 的方式对运行/调试配置进行分组。

要创建文件夹,请选择一个分类下的多个配置,点击 文件夹 ,并指定文件夹名称。 如果仅选中分类,将创建一个空文件夹。

然后,若要将配置移动到文件夹、在文件夹之间移动或移出文件夹,可使用拖动方式或点击 上移下移 按钮。

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

排序配置

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

启动前

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

项目

快捷键

描述

添加按钮

Alt+Insert

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

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

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

  • 运行另一个配置 :选择此选项以执行另一个运行/调试配置,并等待其完成后再启动当前配置。 如果希望并行运行多个配置,请使用 compound run/debug configuration

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

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

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

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

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

移除按钮

Alt+Delete

单击此图标可将所选任务从列表中删除。

编辑

Enter

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

方法上移

方法下移

Alt+Up

Alt+Down

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

显示此页面

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

激活工具窗口

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

否则,如果取消选中复选框,则该工具窗口将被隐藏。 不过,当配置正在运行时,您可以按 Alt+4Alt+5 自行打开相应的工具窗口。

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