Gulp 工具窗口

使用此工具窗口运行 Gulp.js 任务。执行任务的结果会显示在运行工具窗口中。该工具窗口显示 Gulp.js 输出，报告发生的错误，列出未找到的包或插件等。上次执行的任务名称会显示在工具窗口的标题栏中。

在开始之前

下载并安装 Node.js。
全局安装 gulp-cli 包（Gulp 命令行界面），并将 gulp 包安装为开发依赖。有关详细信息，请参阅安装 Gulp.js。

运行任务

打开 Gulp 工具窗口

在项目工具窗口 Alt+1 中选择所需的 Gulpfile.js 文件，或在编辑器中将其打开并在上下文菜单中选择显示 Gulp 任务。

默认情况下，PyCharm 不识别 Gulpfile.js 中的 ES6，因此无法构建任务树。要解决此问题，请更新默认 Gulp.js 运行配置。

从 ES6 Gulpfile.js 构建任务树

转到运行 | 编辑配置。或者，在工具栏的运行小部件中选择编辑配置。
在模板节点下，点击 Gulp.js。
在打开的运行/调试配置： Gulp.js 对话框中，请在 Node 参数字段中输入 --harmony ，然后点击确定。

构建任务树

在 Gulp 工具窗口中，点击工具栏上的，然后从列表中选择所需的 Gulpfile.js 文件。默认情况下， PyCharm 会显示项目根目录中的 Gulpfile.js 文件。
如果您有其他 Gulpfile.js 文件，请点击选择 Gulpfile.js ，并在打开的对话框中选择所需的 Gulpfile.js 文件。 PyCharm 会添加一个新节点，其标题包含所选 Gulpfile.js 文件的路径，并在该新节点下构建任务树。

重新构建树

切换到所需节点，然后点击工具栏上的。

按名称对树中的任务进行排序

点击工具栏上的，从菜单中选择排序依据，然后选择名称。
默认情况下，树显示任务的顺序与它们在 Gulpfile.js 中定义的顺序相同（选项定义顺序）。

运行任务

双击任务。
在树中选择任务，然后按 Enter ，或从上下文菜单中选择运行 <task name>。

运行默认任务

在树中选择根节点，然后在所选内容的上下文菜单中选择运行默认。

运行多个任务

使用多选模式：按住 Shift （用于相邻项目）或 Ctrl （用于不相邻项目）键并选择所需的任务，然后从所选内容的上下文菜单中选择运行或调试。

导航到任务的定义

在树中选择所需的任务，然后从所选内容的上下文菜单中选择跳转到源代码。

工具栏

	添加 Gulpfile	点击此按钮以为另一个 Gulpfile.js 文件构建任务树。在列表中选择所需的 Gulpfile.js 文件。 PyCharm 会构建任务树，并将其显示在单独的节点下。
	移除 Gulpfile	点击此按钮可移除所选节点下的任务树。
	重新加载任务	点击此按钮可重新构建所选节点下的任务树。更新相应的 Gulpfile.js 文件后，您可能需要重新构建树，因为 Gulp.js 不会即时将更改应用到树。
	全部折叠	点击此按钮可隐藏所有任务树，仅显示 Gulpfile.js 节点。
		点击此按钮以配置当前视图，并更改工具窗口的查看模式。更多信息，请参见工具窗口视图模式。请注意，大多数菜单项都是可打开或关闭的选项。已开启的选项在其名称左侧带有复选标记。特定于 Gulp 的选项包括： Gulp 设置：选择此选项以打开 Gulp 设置对话框，并更新 Gulp 及 Node.js 运行时的当前设置，参阅 Gulp。排序依据：选择此选项以配置树中任务的显示顺序。点击工具栏上的按钮，从菜单中选择排序依据，然后选择名称。默认情况下，树显示任务的顺序与它们在 Gulpfile.js 中定义的顺序相同（选项定义顺序）。
	隐藏	点击此按钮以隐藏工具窗口。要再次显示它，请在主菜单中选择视图 \| 工具窗口 \| Gulp。工具窗口将再次显示，包含所有先前构建的任务树。

树的上下文菜单

Gulp 设置	选择此菜单项以打开 Gulp 设置对话框并查看或编辑 Node.js 配置。
跳转到源代码	选择此菜单项以打开用于构建当前树的 Gulpfile.js 文件。
重新加载任务	选择此菜单项可重新构建所选节点下的任务树。
复制路径	选择此菜单项可将用于构建当前树的 Gulpfile.js 文件路径保存到剪贴板。
移除 Gulpfile.js	选择此菜单项可移除所选节点下的任务树。

任务的上下文菜单

运行 <task name>	选择此菜单项以运行所选任务。
调试 <task name>	选择此菜单项以调试所选任务。
编辑<任务名称>设置	选择此菜单项以打开运行/调试配置对话框并编辑所选任务的预定义设置。
跳转到源代码	选择此菜单项以打开为其构建当前树的 Gulpfile.js 文件，并导航到所选任务的定义。

2026年 3月 24日