# 运行/调试配置：Gulp.js > For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt). > **TL;DR** > 必需插件 : > > > > `JavaScript 和 TypeScript`  -  插件与 IntelliJ IDEA 捆绑在一起，并默认启用。 创建： `运行 | 编辑配置 |` ![添加新配置](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) `| Gulp.js` 在此对话框中，创建运行 Gulp.js tasks 的配置。 ## 开始之前 Procedure: 1. 下载并安装 [Node.js](http://nodejs.org/#download)。 2. 请按照 [安装 Gulp.js](using-gulp-task-runner.html#installingGulp)中的描述安装 gulp 包。 ## Gulp.js 特定的配置设置 | 条目 | 描述 | | --- | --- | | Gulpfile | 在此字段中，指定 `Gulpfile.js` 文件的位置以检索任务的定义。 从下拉列表中选择路径或点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg)按钮并从打开的对话框中选择文件。 | | 任务 | 在此字段中，指定要运行的任务。 请执行以下操作之一： * 要运行任务，请从下拉列表中选择任务。 * 若要运行多个任务，请在字段中键入它们的名称，并使用空格作为分隔符。 | | 参数 | 在此字段中，指定要执行的任务参数。 请使用格式 `-- ` ，例如： `--env development` 。 可从 [Gulp 官方网站](https://github.com/gulpjs/gulp/blob/master/docs/recipes/pass-arguments-from-cli.md) 了解更多信息。 | | 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 选项 | 在此字段中，键入要传递给 Node.js 可执行文件的 Node.js 特定命令行选项。 如需更多信息，请参阅 [Node Parameters](run-debug-configuration-node-js.html#node_parameters)。 在 默认 配置中，在此字段中输入 `--harmony` ，以使 IntelliJ IDEA 根据 `Gulpfile.js` 构建一个任务树，用 ECMA6 编写。 从技术上讲，IntelliJ IDEA 会调用 Gulp.js 并处理 `Gulpfile.js` ，根据 默认 Gulp.js 运行配置 。 这是在静默中完成的，无需您执行任何步骤。 然而，如果您的 `Gulpfile.js` 是用 [ECMA6](https://github.com/lukehoban/es6features/blob/master/README.md) 编写的，默认情况下 IntelliJ IDEA 无法识别此格式，并且会构建任务树失败。 要解决这个问题，请将 `--harmony` 指定为 节点参数 的 默认 Gulp.js 运行配置 。 | | Gulp 包 | 在此字段中，指定项目根目录下 本地 安装的 gulp 软件包的路径。 如需更多信息，请参阅 [Installing Gulp.js](using-gulp-task-runner.html#installingGulp)。 | | 环境变量 | 在此字段中，指定 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/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)) 自行打开相应的工具窗口。 | ## See also ### 过程 [Gulp](using-gulp-task-runner.html) ### 参考 [Gulp 工具窗口](gulp-tool-window.html)