Grunt 工具窗口

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

在开始之前

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

运行任务和目标

要打开 Grunt 工具窗口

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

构建任务树

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

重新构建树

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

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

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

要运行任务或目标

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

运行默认任务

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

要运行多个任务或目标

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

要跳转到任务或目标的定义

在树中选择所需的任务或目标，并从上下文菜单中选择跳转到源代码。

工具栏

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

树的上下文菜单

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

任务或目标的上下文菜单

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

2026年 3月 24日