Grunt
PyCharm 与 Grunt JavaScript 任务运行器 集成。 PyCharm 解析 Gruntfile.js 文件,识别任务和目标的定义,在树形视图中显示任务和目标,允许您在树中的任务或目标与其在 Gruntfile.js 文件中的定义之间导航,并支持运行和调试任务和目标。
借助 PyCharm,您可以在专用的 Grunt 工具窗口 的任务树中运行 Grunt 任务,或使用 Grunt 运行配置 ,或将其作为启动前任务运行。 PyCharm 会在 运行工具窗口 中显示任务的执行结果。 该工具窗口会显示 Grunt 输出、报告发生的错误、列出未找到的包或插件等。 上次执行的任务名称显示在工具窗口的标题栏上。
开始之前
请确保您的计算机上已安装 Node.js。
安装 Grunt
要在 一个 PyCharm 项目中使用 Grunt,您需要两个包:
一个全局安装的 grunt-cli 包(Grunt 命令行界面),用于执行 Grunt 命令。
一个作为开发依赖安装的 grunt 包,用于构建项目任务树,并在编辑 Gruntfile.js 或 Gruntfile.coffee 文件时提供编码辅助。 在 Grunt 官方网站 了解有关 Gruntfile.js 的更多信息。
全局安装 grunt-cli
在嵌入式 终端 (Alt+F12 )中,输入:
npm install -g grunt-cli
在项目中安装 Grunt
在嵌入式 终端 (Alt+F12 )中,输入:
npm install grunt --save-dev
从任务树运行 Grunt 任务
PyCharm 允许您直接在 Grunt 工具窗口的任务树中快速便捷地运行 Grunt 任务。 PyCharm 会自动创建一个临时运行配置,必要时您可以将其保存并在稍后使用。
打开 Grunt 工具窗口
在 一个 PyCharm 会话期间首次构建任务树时, Grunt 工具窗口尚未打开。
在 项目 工具窗口 Alt+1 中选择所需的 Gruntfile.js 文件,或在编辑器中将其打开并从上下文菜单中选择 显示 Grunt 任务。
在 Grunt 工具窗口中构建任务树
在 Grunt 工具窗口中,点击工具栏上的
,并从列表中选择所需的 Gruntfile.js 文件。 默认情况下,PyCharm 会在项目的根目录中显示 Gruntfile.js 文件。
如果您有另一个 Gruntfile.js 文件,点击 选择 Gruntfile.js 并在打开的对话框中选择所需的 Gruntfile.js 文件。 PyCharm 会添加一个新节点,在其标题中显示所选 Gruntfile.js 文件的路径,并在该新节点下构建任务树。
重新构建任务树
切换到所需的节点,并点击工具栏上的
。
按名称对树中的任务进行排序
点击工具栏上的
,从菜单中选择 排序依据 ,然后选择 名称。
默认情况下,树会按 Gruntfile.js 中定义的顺序显示任务(选项 定义顺序)。
运行任务或目标
双击任务或目标。
在树中选择任务或目标,并按 Enter ,或从上下文菜单中选择 运行 <任务名称>。
请注意,当您从任务树运行任务时, 强制执行 和 详细模式 选项不可用。 因此,您无法配置 PyCharm,例如忽略警告或输出详细日志。 要使用这些选项,请按照下文 根据运行配置运行和调试任务 中的说明,从运行配置运行任务或目标。
运行默认任务
在树中选择根节点,并从上下文菜单中选择 运行默认任务。
运行多个任务或目标
使用多选模式:按住 Shift 键(用于相邻项)或 Ctrl 键(用于非相邻项),并选择所需的任务或目标,然后从上下文菜单中选择 运行 或 调试。
跳转到任务或目标的定义
在树中选择所需的任务或目标,并从上下文菜单中选择 转到源。
根据运行配置运行和调试任务
除了使用 PyCharm 在您从任务树运行任务或目标时自动创建的 临时 运行配置,您还可以创建并运行您自己的 Grunt.js 运行配置。
创建 Grunt.js 运行/调试配置
转到 。 或者,从工具栏上的 运行 组件中选择 编辑配置。

在 编辑配置 对话框中,点击工具栏上的 添加 按钮(
),并从列表中选择 Grunt.js。 将打开 运行/调试配置: Grunt.js 对话框。
指定运行配置的名称、要运行的任务(使用空格作为分隔符)、定义这些任务的 Gruntfile.js 文件的位置,以及全局安装的 grunt-cli 包的路径。
指定要使用的 Node.js 运行时。
如果您选择 项目 别名,PyCharm 将自动使用 JavaScript 运行时 页面中 Node 运行时 字段的项目默认解释器。 在大多数情况下,PyCharm 会检测到项目默认运行时并自动填充该字段。
您也可以选择其他已配置的本地或远程解释器,或点击
并配置一个新的解释器。
可选地指定要传递给 Node.js 的 Node.js 特定的选项参数 和 环境变量。
运行任务
从工具栏上的 运行/调试配置 组件列表中,选择新建的 配置,并点击其旁边的
。 PyCharm 会在 运行工具窗口 中显示任务的执行结果。
调试任务
将 Grunt 任务作为启动前任务运行
打开 运行/调试配置对话框 对话框,方法是在主菜单中选择 ,并从列表中选择所需的配置,或点击
并选择相关的运行配置类型。
在打开的对话框中,点击 启动前 区域中的
,并从列表中选择 运行 Grunt 任务。
在打开的 Grunt 任务 对话框中,指定定义所需任务的 Gruntfile.js ,选择要执行的任务,并指定传递给 Grunt 工具的参数。
指定 Node.js 运行时的位置、要传递给它的参数,以及 grunt-cli 包的路径。
自动运行 Grunt 任务
如果您有一些经常运行的任务或目标,您可以将相应的运行配置添加到 启动任务 列表中。 这些任务会在项目启动时自动执行。