# 运行/调试配置：NPM

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> 所需插件：
>
>
>
> `JavaScript 和 TypeScript`  -  插件与 IntelliJ IDEA 捆绑在一起，并默认启用。
>
>
>
> `Node.js`  -  在   设置 | 插件   页面上安装插件。 该插件仅在拥有 Ultimate 订阅的 IntelliJ IDEA 中可用。

创建：  `运行 | 编辑配置 |`  ![添加新配置](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)  `| NPM`

在此对话框中，创建本地运行 [npm](https://docs.npmjs.com/misc/scripts) 和 [Yarn](https://yarnpkg.com/en/) 脚本的配置。 当前上下文中的“本地”指 IntelliJ IDEA 自行启动安装在您计算机上的  Node.js ，随后开始执行脚本。

有关更多信息，请参阅 [npm、pnpm 和 Yarn](installing-and-removing-external-software-using-node-package-manager.html)。

如果脚本在开发模式下启动应用程序，您可以修改配置，使其也启动调试会话。 要实现这一点，请转到 [Browser / Live Edit 选项卡](#run_configurations_npm_browser_live_edit_tab)，并在那里指定应用程序运行的 URL 地址。 了解更多信息，请参阅 [使用单个 npm run/debug 配置运行和调试 Angular 应用程序](run-and-debug-angular-applications.html#angular_debug_two_rc) 、 [通过单个 npm run/debug 配置运行和调试 Vue.js 应用程序](vue-js.html#vue_debug_two_rc) 和 [使用单个 npm run/debug 配置运行和调试 Vite 应用程序](vite.html#vite_debug_two_rc) 。

## 开始之前

Procedure:

1. 下载并安装 [Node.js](http://nodejs.org/#download)。 请注意，npm 也已安装，因此如果您要使用它，则已经完成了初步步骤。

2. 要使用 Yarn，请按照 [Yarn 官方网站](https://yarnpkg.com/en/docs/install)上的说明进行安装。

## 配置选项卡

|  条目  |  描述  |
| --- | --- |
|  package.json  |  在此字段中，请指定  `package.json`  文件来运行脚本。 从下拉列表中选择文件，该列表显示当前项目中检测到的所有  `package.json`  文件，或点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) 并在打开的对话框中选择所需的  `package.json` 。  |
|  命令  |  从此列表中，选择要执行的  npm CLI command ，默认情况下会选择  `run-script` 。 请参见 [npm 文档](https://docs.npmjs.com/) 中的相关章节了解更多信息   CLI 命令  。  |
|  脚本  |  从此下拉列表中选择将应用所选命令的脚本。 列表包含  `scripts`  属性中  `package.json`  文件中定义的所有脚本。  |
|  参数  |  在此字段中，指定用于执行脚本的命令行参数。 了解更多信息，请访问 [npm 官方网站](https://docs.npmjs.com/cli/v10/commands/npm-run-script?utm_source=chatgpt.com)。  |
|  Node.js 运行时  |     在此字段中，指定要使用的 Node.js 运行时。       如果您选择   项目   别名， IntelliJ IDEA 将自动使用在 [JavaScript 运行时](javascript-runtime.html) 页面上   Node.js 运行时   字段中的项目默认解释器。 在大多数情况下， IntelliJ IDEA 会检测到项目的默认运行时，并自动填写该字段。       您还可以选择其他已配置的本地或远程解释器，或点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) 并配置一个新的解释器。     |
|  节点选项  |     在此字段中，键入要传递给 Node.js 可执行文件的 Node.js 特定命令行选项。 可接受的选项是：        * 使用 `--require coffeescript/register` ，运行期间可以将 CoffeeScript 文件即时编译为 JavaScript。 此模式要求 `register.js` 文件位于项目中，该文件是 `coffeescript` 软件包的一部分。 因此，请确保已在本地安装 `coffeescript` 软件包，如 [安装 CoffeeScript 编译器](coffeescript.html#ws_coffee_installation)中所述。    * 使用 `--inspect` 或 `--inspect-brk` 参数以支持 [Chrome Debugging Protocol](https://developer.chrome.com/devtools/docs/debugger-protocol)。    |
|  包管理器  |  指定要使用的软件包管理器。 如果选择  `项目`  别名，IntelliJ IDEA 将使用来自 [JavaScript 运行时](javascript-runtime.html) 页面的默认项目包管理器。 您还可以选择相关的软件包别名（  npm  或  yarn ）或指定自定义安装的软件包管理器的显式路径。  |
|  环境变量  |     在此字段中，指定 Node.js 可执行文件的自定义 [环境变量](https://www.w3schools.com/nodejs/nodejs_environment.asp)。       变量定义显示在   环境变量   字段中，并用分号 (  `;` ) 分隔，例如：        * `NODE_PATH` 用于解析模块时搜索的附加目录列表。 在 macOS 或 Linux 上，目录列表请用冒号 ( `:` ) 分隔；在 Windows 上请用分号 ( `;` ) 分隔。    * `NODE_MODULE_CONTEXTS` 设置为 1 以在各自的全局上下文中加载模块。    * `NODE_DISABLE_COLORS` 设置为 1 以在 REPL 中禁用颜色。     ![环境变量](https://resources.jetbrains.com/help/img/idea/2026.3/nodeEnvironmentVariables.png)    或者，点击字段右侧的   浏览   ![编辑环境变量](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.inline.variables.svg)，并在打开的   环境变量   对话框中配置变量列表：        * 请使用 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.copy.svg) 和 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.paste.svg) 按钮来管理自定义变量列表。    * 该对话框还会显示可用的系统环境变量列表。 如果不想为当前配置使用系统环境变量，请清除 包括系统环境变量 复选框。    * 准备就绪后，点击 OK 。    |
|  Docker 容器设置  |     此只读字段显示端口和卷绑定。 请点击 ![“展开”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.expandComponent.svg)以打开命令预览。      > **Warning:** > 仅当选择 [基于 Docker 的远程解释器](node-with-docker.html#ws_node_docker_configure_remote_interpreter_preferences_remote_interpreters_dialog)时才显示此字段。     ![检查 Docker 容器设置](https://resources.jetbrains.com/help/img/idea/2026.3/ws_npm_docker_run_configuration_docker_container_settings.png)  |
|  Docker Compose  |     在此区域中，指定要传递给 Docker Compose 的命令和选项。 接受默认设置或点击 ![“展开”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.expandComponent.svg)并指定自定义设置，比如，自定义 Docker Compose 标志，如  `--rm` 或  `--service-ports` 。 了解更多信息，请访问 [Docker 官方网站](https://docs.docker.com/compose/reference/)。       请检查   命令预览  。      > **Warning:** > 仅在选择 [通过 Docker Compose 的远程运行时](node-with-docker-compose.html#ws_node_docker_compose_configure_interpreter) 时，才会显示此字段。    |

### 通用设置

当您编辑运行配置（但不是运行配置模板）时，您可以指定以下选项：

|  条目  |  描述  |
| --- | --- |
|    名称    |  在编辑或运行时，指定运行配置的名称以便快速识别。  |
|    允许多个实例    |     允许并行运行此运行配置的多个实例。       默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置，IntelliJ IDEA 建议停止正在运行的实例并启动另一个。 当一个运行配置消耗大量资源且没有充分理由运行多个实例时，这会很有帮助。     |
|    存储为项目文件    |     将运行配置设置的文件保存下来，与其他团队成员共享。 默认位置是  `.idea/runConfigurations` 。 但是，如果您不想共享  `.idea` 目录，您可以将配置保存到项目内的任何其他目录。       默认情况下，它是禁用的，并且 IntelliJ IDEA 将运行配置设置存储在  `.idea/workspace.xml` 。     |

### 工具栏

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

|  条目  |  快捷键  |  描述  |
| --- | --- | --- |
|  !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)  |  `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))  |  创建运行/调试配置。  |
|  !["移除"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)  |  `Alt+Delete` (Windows), `⌘ ⌦` (macOS), `⌘ ⌦` (IntelliJ IDEA Classic (macOS)), `⌘ ⌦` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `⌘ ⌦` (Sublime Text (macOS)), `Ctrl+R, D` (Visual Studio), `⌘ R, D` (Visual Studio (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))  |  删除选定的运行/调试配置。 请注意，您不能删除默认配置。  |
|  ![复制](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.copy.svg)  |  `Ctrl+D` (Windows), `⌘ D` (macOS), `⌘ D` (IntelliJ IDEA Classic (macOS)), `⌘ D` (macOS System Shortcuts), `Ctrl+D` (XWin), `Ctrl+D` (GNOME), `Ctrl+D` (KDE), `Meta+D` (Emacs), `Ctrl+Shift+D` (Sublime Text), `⌘ ⇧ D` (Sublime Text (macOS)), `Ctrl+D` (Visual Studio), `⌘ D` (Visual Studio (macOS)), `Ctrl+D` (NetBeans), `Ctrl+D` (Eclipse), `Ctrl+D` (Eclipse (macOS))  |  创建选定运行/调试配置的副本。 请注意，将会创建默认配置的副本。  |
|  ![保存配置](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.save.svg)  |  |  仅当选择 [临时配置](null)时，才会显示该按钮。 点击此按钮以将临时配置保存为永久配置。  |
|  ![移动到新文件夹 / 创建新文件夹](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.actions.newFolder.svg)  |  |     移动到新文件夹 / 创建新文件夹。 您可以通过 [将它们放入文件夹](run-debug-configuration.html#config-folders)来对运行/调试配置进行分组。       要创建文件夹，请选择某个类别中的配置，点击 ![文件夹](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.nodes.folder.svg)，并指定文件夹名称。 如果只有一个类别处于焦点状态，则会创建一个空文件夹。       然后，若要将配置移入文件夹、在文件夹之间移动或移出文件夹，请使用拖放操作或 ![上移](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveUp.svg) 和 ![下移](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveDown.svg) 按钮。       要移除分组，请选择一个文件夹，然后点击 ![移除配置](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)。     |
|  ![排序配置](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.objectBrowser.sortAlphabetically.svg)  |  |  点击此按钮以按字母顺序对配置进行排序。  |

### 启动前

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

|  条目  |  快捷键  |  描述  |
| --- | --- | --- |
|  !["添加"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)  |  `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))  |     点击此图标以添加以下可用任务之一：        * 启动 Web 浏览器‍™™™™™™™‍ ：选择此选项以启动浏览器。 在打开的对话框中，选择浏览器类型并提供起始 URL。 此外，请指定是否要使用 JavaScript 调试器启动浏览器。    * 运行外部工具 ：选择运行外部应用。 在打开的对话框中，选择您想要运行的一个或多个应用程序。 如果它在 IntelliJ IDEA 中尚未定义，请添加其定义。 如需更多信息，请参阅 [外部工具](configuring-third-party-tools.html) 和 [外部工具设置](settings-tools-external-tools.html)。    * 运行另一个配置 ：选择执行另一个运行/调试配置，并等待其完成后再启动当前配置。 如果您想并行运行多个配置，请使用 [compound run/debug configuration](run-debug-multiple.html#compound-configs)。    * 构建 ：选择编译指定的模块。 [Build Module命令](compiling-applications.html#compile_module) 将会被执行。 如果在编译过程中发生错误，IntelliJ IDEA 将不会尝试启动运行/调试配置。    * 构建项目 ：选择编译整个项目。 [Build Project 命令](compiling-applications.html#compile_module) 将被执行。 如果在编译过程中发生错误，IntelliJ IDEA 将不会尝试启动运行/调试配置。    * 构建，不进行错误检查 ：与 构建 选项相同，但 IntelliJ IDEA 将会尝试启动运行/调试配置，而不考虑编译结果。    * 构建制品 ：选择此选项以构建一个或多个 [构件](working-with-artifacts.html)。 在打开的对话框中，选择应构建的 artifact。    * 运行远程外部工具 ：添加一个 [远程 SSH 外部工具](settings-tools-remote-ssh-external-tools.html)。    * 运行 Grunt 任务 ：选择此选项以运行 Grunt 任务。 在打开的 Grunt 任务 对话框中，指定定义所需任务的 `Gruntfile.js` ，选择要执行的任务，并指定传递给 Grunt 工具的参数。 指定 Node.js 解释器的位置、传递给它的参数以及 grunt-cli 包的路径。    * 运行 Gulp 任务 ：选择此选项以运行 Gulp 任务。 在打开的 Gulp 任务 对话框中，请指定定义所需任务的 `Gulpfile.js` ，选择要执行的任务，并指定传递给 Gulp 工具的参数。 指定 Node.js 运行时的位置、要传递给它的参数，以及 gulp 包的路径。    * 运行 Maven 目标 ：选择此选项以 [运行一个 Maven 目标](work-with-maven-goals.html)。 在打开的对话框中，选择要运行的目标。    * 运行 npm 脚本 ：选择此选项以执行 npm script。 在打开的 npm 脚本 对话框中，指定 [npm 运行/调试配置设置](null)。    * 编译 TypeScript ：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中，选择或清除 检查错误 复选框，以配置在检测到任何错误时编译器的行为： * 如果选中 检查错误 复选框，编译器将显示所有错误，运行配置将不会启动。 * 如果取消选中 检查错误 复选框，编译器将显示所有检测到的错误，但仍会启动运行配置。    * 生成 CoffeeScript 源代码映射图 ：选择此选项以为您的 [CoffeeScript](coffeescript.html) 源文件生成源代码映射。 在打开的对话框中，指定您的 CoffeeScript 源文件所在的位置。    * 运行 Rake 任务 ：添加一个 [Rake 任务](null)，以便在运行或调试之前执行。 要选择 Rake 任务，请点击浏览按钮 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)，然后从可用任务列表中选择所需的任务。 请注意，此处可使用 [代码补全](auto-completing-code.html)。 ![Rake 任务的代码补全](https://resources.jetbrains.com/help/img/idea/2026.3/runConfigRakeTask.png)    * 运行 JRuby 编译器 ：选择此选项，以使用指定的目标路径、编译器进程堆大小和命令行形参（如果有）执行 JRuby 编译器。    |
|  !["移除"按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)  |  `Alt+Delete` (Windows), `⌘ ⌦` (macOS), `⌘ ⌦` (IntelliJ IDEA Classic (macOS)), `⌘ ⌦` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `⌘ ⌦` (Sublime Text (macOS)), `Ctrl+R, D` (Visual Studio), `⌘ R, D` (Visual Studio (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))  |  点击此图标以从列表中删除所选任务。  |
|  ![编辑](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg)  |  `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS))  |  点击此图标以编辑所选任务。 在打开的对话框中进行必要的更改。  |
|     ![方法 up](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveUp.svg)       ![方法 down](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveDown.svg)     |     `Alt+Up` (Windows), `⌃ ⇧ ↑` (macOS), `⌃ ↑` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ ↑` (macOS System Shortcuts), `Alt+Up` (XWin), `Alt+Up` (GNOME), `Alt+Up` (KDE), `Alt+Up` (Emacs), `Alt+Up` (Sublime Text), `Alt+Up` (Sublime Text (macOS)), `Alt+Up` (Visual Studio), `⌃ ⇧ ↑` (Visual Studio (macOS)), `Ctrl+Alt+Up` (NetBeans), `Ctrl+Shift+Up` (Eclipse), `⌃ ⌥ ↑` (Eclipse (macOS))       `Alt+Down` (Windows), `⌃ ⇧ ↓` (macOS), `⌃ ↓` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ ↓` (macOS System Shortcuts), `Alt+Down` (XWin), `Alt+Down` (GNOME), `Alt+Down` (KDE), `Alt+Down` (Emacs), `Alt+Down` (Sublime Text), `Alt+Down` (Sublime Text (macOS)), `Alt+Down` (Visual Studio), `⌃ ⇧ ↓` (Visual Studio (macOS)), `Ctrl+Alt+Down` (NetBeans), `Ctrl+Shift+Down` (Eclipse), `⌃ ⌥ ↓` (Eclipse (macOS))     |  点击这些图标可以将所选任务在列表中上下移动一行。 任务按照它们在列表中出现的顺序执行。  |
|  显示此页面  |  |  选中此复选框，以在实际启动运行/调试配置之前显示运行/调试配置设置。  |
|  激活工具窗口  |  |     默认情况下，将选中此复选框，启动运行/调试配置时将打开 [Run](run-tool-window.html) 或 [Debug](debug-tool-window.html) 工具窗口。       否则，如果复选框被清除，工具窗口将被隐藏。 但是，当配置运行时，您可以通过按 `Alt+4` (Windows), `⌘ 4` (macOS), `⌘ 4` (IntelliJ IDEA Classic (macOS)), `⌘ 4` (macOS System Shortcuts), `Alt+4` (XWin), `Alt+4` (GNOME), `Alt+4` (KDE), `Alt+4` (Emacs), `Alt+4` (Sublime Text), `⌘ 4` (Sublime Text (macOS)), `Alt+4` (Visual Studio), `⌘ 4` (Visual Studio (macOS)), `Alt+4` (NetBeans), `Alt+4` (Eclipse), `⌘ 4` (Eclipse (macOS)) 或 `Alt+5` (Windows), `⌘ 5` (macOS), `⌘ 5` (IntelliJ IDEA Classic (macOS)), `⌘ 5` (macOS System Shortcuts), `Alt+5` (XWin), `Alt+5` (GNOME), `Alt+5` (KDE), `Alt+5` (Emacs), `Alt+5` (Sublime Text), `⌘ 5` (Sublime Text (macOS)), `Alt+5` (Visual Studio), `⌘ 5` (Visual Studio (macOS)), `Alt+5` (NetBeans), `Alt+5` (Eclipse), `⌘ 5` (Eclipse (macOS)) 自行打开相应的工具窗口。     |

## 浏览器 / 实时编辑 选项卡

如果您希望运行/调试配置在开发模式下启动应用程序并同时开始调试会话，请使用此选项卡中的控件。 从 [使用单个 npm run/debug 配置运行和调试 Angular 应用程序](run-and-debug-angular-applications.html#angular_debug_two_rc)、 [通过单个 npm run/debug 配置运行和调试 Vue.js 应用程序](vue-js.html#vue_debug_two_rc) 和 [使用单个 npm run/debug 配置运行和调试 Vite 应用程序](vite.html#vite_debug_two_rc) 了解更多。

您还可以启用 IntelliJ IDEA 在浏览器中打开应用程序。

|  条目  |  描述  |
| --- | --- |
|  打开浏览器  |     在此区域中，启用应用程序在浏览器中打开。        * 在启动后 - 选择此复选框以在启动时打开应用程序。 从列表中选择浏览器以打开应用程序。 > **Note:** > 如果要调试应用程序，请选择 [Google Chrome](http://www.google.com/chrome/) 或其他 [基于 Chromium 的浏览器](https://www.chromium.org/)。    * URL - 在此字段中，指定应用程序将运行的 URL 地址。    * 使用 JavaScript 调试器 - 选中此复选框，即可在应用程序以开发模式启动时同时开始调试会话。    |

## 步进选项卡

在此选项卡上，指定 [步进](stepping-through-the-program.html#step-into) 选项。

某些脚本（例如标准 Java 类的方法，如  `系统` ）会被   步入   跳过，因为通常可能不需要调试它们。 您可以在  `构建、执行、部署 | 调试器 | 单步调试`  页面的   设置   对话框中（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）微调此列表。

Procedure:

1. 打开运行/调试配置以启动调试会话，并切换到   步进   选项卡。

2. 要禁止自动   智能步入  ，请清除   始终使用智能步入   复选框。

3. 要跳过源代码映射的  `ignoreList`  字段中的脚本，请选中   忽略源代码映射中指定的已知第三方脚本   复选框。

较旧的 Chrome 专用字段名称  `x_google_ignoreList`  已弃用，但当缺少  `ignoreList`  字段时，仍可能被识别。 从 [源代码映射规范](https://tc39.es/ecma426/#sec-source-map-format) 中了解详情。

4. 要禁止步进进入自定义脚本，请选中   不步入 URL 与以下模式匹配的脚本   复选框，并展开下面此类脚本的默认列表。 使用  `*` 、  `?` 、  `**`  和  `!` 。

![步进选项卡](https://resources.jetbrains.com/help/img/idea/2026.3/npm_stepping_tab.png)

### 模式语法

模式中支持以下字符：

* 星号 `*` 会匹配除斜杠 `/` 以外的零个或多个字符。 在单个路径部分内使用此字符。

* 问号 `?` 会匹配除斜杠 `/` 以外的正好一个字符。

* 双星号 `**` 作为整个段时，会匹配零个或多个路径段。 其含义取决于它的位置： * 作为第一部分时，它会匹配任意前导符号。 * 作为最后一部分时，它会匹配任意尾随符号。 * 在中间时，它会匹配一个或多个部分。 例如， `a/**/b` 会匹配 `a/x/b` 和 `a/x/y/b` ，但不匹配 `a/b` 。

* 位于最后一个段末尾的尾随双星号 `**` （本身不是一个完整段，例如 `foo**` ）会匹配该段之后的任何后缀。 例如， `foo**` 会匹配 `foo` 、 `foobar` 和 `foo/bar` 。

* 以感叹号 `!` 开头的模式会对给定模式取反，并修改列表中在它之前添加的模式。 它本身不会添加新模式。

示例 1
: 在模式列表  `["**/*.ts", "!**/*.test.ts"]`  中，第一个 glob 会匹配每个  `.ts`  文件。 第二个模式会修改第一个 glob，以从匹配中排除每个  `.test.ts`  文件。

示例 2
: 传入的 URL 会通过斜杠  `/`  拆分为多个部分。 因此，  `**/node_modules/**`  会按如下方式拆分::
:
:
:
: 1.  双星号  `**`  会匹配  `node_modules`  段之前的任何路径。
:
: 2.   `node_modules`  会匹配 URL 中的  `node_modules` 。
:
: 3.  双星号  `**`  会匹配后面的任何内容。
:
:
:
: 因此，模式  `**/node_modules/**`  会匹配包含  `node_modules`  的任何 URL。
:
:
:
: 请记住，脚本的 URL 会与整个模式进行匹配。 如果移除第二个双星号  `**` ，该模式将匹配任何以  `node_modules`  结尾的 URL，而这样的 URL 可能为零。

示例 3
: 跳过第二个双星号  `**` ，以匹配以特定文件名结尾的任何模式。
:
:
:
: * `**/app.js` 会匹配所有以 `app.js` 结尾的 URL。
:
: * 以下模式列表将忽略 `node_modules` 中除名称为 `app.js` 的脚本之外的所有脚本。 ``` **/node_modules/** !**/app.js ```

## See also

### 过程

[运行应用程序](running-applications.html) [调试代码](debugging-code.html)

### 参考

[运行/调试配置：连接到 Node.js/Chrome](run-debug-configuration-node-js-remote-debug.html)

