WebStorm 2025.2 Help

运行/调试配置:Spy-js

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

本页介绍特定于配置的条目以及适用于所有运行/调试配置的 选项。 有关使用此配置的详细信息,请参阅 使用 Spy-js 对 JavaScript 进行性能分析

在此对话框中,使用 Spy-js tool 创建用于跟踪 Web 应用程序的配置。

开始之前

  1. 下载并安装 Node.js

  2. 请确保在 已安装 页的 设置 | 插件 选项卡中启用了 Node.js 捆绑插件,如 安装插件 中所述。

  3. 设置 | 插件 页的 Marketplace 选项卡中安装 Spy-js 插件,如 从 JetBrains Marketplace 安装插件 中所述。

Spy-js 专用配置设置

描述

Node 解释器

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

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

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

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

跟踪服务器端口

在此字段中,指定 Spy-js 作为代理服务器使用的端口。

跟踪服务器端口 会自动填充。 为避免端口冲突,建议接受建议的值并保持选中 自动配置系统代理 复选框。 结果是,系统代理服务器会自动设置为所指定的端口号。

或者,手动配置系统代理端口。

进入 设置 | Windows 设置 | 网络和 Internet | 代理 并启用 使用代理服务器。 在 端口 字段中,输入 跟踪服务器端口 号。

请参阅 Microsoft 官方网站 获取更多信息。

前往 系统偏好设置 | 网络 ,点击 高级 ,切换到 代理 选项卡,清除 自动代理配置 ,然后输入代理配置文件的 URL 地址。 请确保该 URL 中的端口与运行/调试配置中设置的 跟踪服务器端口 一致。

请参阅 Apple 官方网站 获取更多信息。

使用

在此字段中,指定配置跟踪会话的方式。

  • 要让 Spy-js 应用其内部预定义的配置,请选择 默认配置

  • 要应用您手动创建的自定义配置,请选择 配置文件 选项,然后在下方的 配置 字段中指定您的自定义配置文件位置。

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

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

要跟踪的 URL

在此字段中,指定要捕获事件的网页的 URL 地址。 默认情况下,此字段为空。 这意味着 Spy-js 会捕获当前打开的所有网页上的事件。 如果您希望仅在某个页面上进行跟踪,请指定其 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

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

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

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

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

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

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

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

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

    在打开的 NPM Script 对话框中,指定 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日