GoLand 2025.2 Help

运行/调试配置:Gulp.js

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

在此对话框中,创建用于运行 Gulp.js 任务 的配置。

开始之前

  1. 下载并安装 Node.js。

  2. 安装 gulp 包。

Gulp.js 专属配置设置

项目

描述

Gulpfile

在此字段中,指定 Gulpfile.js 文件的位置,以从中获取任务定义。 从下拉列表中选择路径,或点击 浏览按钮 按钮并在打开的对话框中选择文件。

任务

在此字段中,指定要运行的任务。 执行下列操作之一:

  • 要运行一个任务,请从下拉列表中选择该任务。

  • 要运行多个任务,请在字段中输入它们的名称,使用空格分隔。

参数

在此字段中,指定要与任务一起执行的参数。 使用格式 --<parameter_name> <parameter_value> ,例如: --env development。 有关更多信息,请参阅 Gulp 官方网站。

Node 解释器

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

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

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

Node 选项

在此字段中,输入要传递给 Node.js 可执行文件的 Node.js 专属命令行选项。

在 默认 配置中,在此字段输入 --harmony 以使 GoLand 根据用 ECMA6 编写的 Gulpfile.js 构建任务树。

技术上,GoLand 调用 Gulp.js 并根据 默认 Gulp.js 运行配置 处理 Gulpfile.js 。 此过程会自动执行,无需您操作。 但如果 Gulpfile.js 是用 ECMA6 编写的,则默认情况下 GoLand 无法识别此格式,进而构建任务树失败。 要解决此问题,请将 --harmony 指定为 Node 参数 的一部分,属于 默认 Gulp.js 运行配置。

Gulp 包

In this field, specify the path to the gulp package installed locally, under the project root.

环境变量

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

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

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

  • 准备就绪后,单击 确定

变量定义显示在只读的 环境变量 字段中,使用分号分隔,例如:

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

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

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

常规设置

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

项目

说明

名称(N)

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

允许多个实例(U)

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

默认情况下,该选项处于禁用状态,当您在另一个实例仍在运行时启动此配置,GoLand 会建议停止正在运行的实例并启动另一个实例。 这在运行配置消耗大量资源、没有合理理由运行多个实例时非常有用。

存储为项目文件(S)

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

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

工具栏

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

项目

快捷键

说明

添加按钮

Alt+Insert

创建运行/调试配置。

移除按钮

Alt+Delete

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

复制

Ctrl+D

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

保存配置

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

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

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

要创建文件夹,请选择某个类别中的配置,单击 文件夹 并指定文件夹名称。 如果仅聚焦某个类别,将创建一个空文件夹。

然后,若要将配置移动到某个文件夹、文件夹之间或移出文件夹,请使用拖拽或 上移 和 下移 按钮。

要移除分组,请选择某个文件夹并单击 移除配置。

排序配置

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

启动前

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

项目

快捷键

说明

添加按钮

Alt+Insert

单击此图标可添加下列可用任务之一:

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

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

  • 运行另一个配置 :选择此选项可执行另一个运行/调试配置,并在开始当前配置前等待其完成。 如果想并行运行多个配置,请使用 复合运行/调试配置。

  • 运行File Watcher :选择此选项以让 GoLand 应用当前所有激活的 File Watcher。

  • 运行远程外部工具 :添加远程 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 编译设置 对话框中,选中或取消选中 检查错误 复选框,以配置检测到错误时编译器的行为:

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

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

  • Go 命令 :选择此项可在运行程序之前执行 Go 命令。 例如,您可以运行 go generate 以在编译之前生成源代码。 在 编辑 Go 命令任务 对话框中,您可以使用自动补全功能。 自动补全支持以下命令: generate、 vet、 test -i。 您可以使用自己的命令。

移除按钮

Alt+Delete

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

编辑

Enter

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

方法上移

方法下移

Alt+Up

Alt+Down

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

显示此页面

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

激活工具窗口

默认情况下,此复选框处于选中状态,启动运行/调试配置时会打开 Run 或 Debug 工具窗口。

否则,如果未选中该复选框,工具窗口将被隐藏。 但是,在配置运行时,您可以按 Alt+4 或 Alt+5 手动打开相应的工具窗口。

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