运行/调试配置： Gulp.js

Gulpfile

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

任务

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

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

• 要运行多个任务，请在该字段中输入其名称，并使用空格分隔。

参数

在此字段中，指定执行任务时使用的参数。 使用格式 --<parameter_name> <parameter_value> ，例如： --env development。 在 Gulp 官方网站 了解详情。

Node.js 运行时

在此字段中，指定要使用的 Node.js 运行时。

如果选择 项目 别名，PyCharm 将自动使用 JavaScript 运行时 页面上 Node 运行时 字段中的项目默认解释器。 在大多数情况下，PyCharm 会检测到项目默认运行时，并自动填写该字段。

您还可以选择其他已配置的本地或远程解释器，或点击 来配置一个新的解释器。

Node.js 选项

在此字段中，输入要传递给 Node.js 可执行文件的 Node.js 特定命令行选项。 有关详细信息，请参阅 Node 参数。

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

从技术上讲，PyCharm 会调用 Gulp.js，并根据 默认 Gulp.js 运行配置 处理 Gulpfile.js 。 这将静默完成，且无需您进行任何操作。 但是，如果您的 Gulpfile.js 是用 ECMA6 编写的，则默认情况下 PyCharm 无法识别此格式，从而无法构建任务树。 要解决此问题，请将 --harmony 指定为 默认 Gulp.js 运行配置 的 Node 参数。

Gulp 包

在此字段中，指定安装在项目根目录下、 本地 的 gulp 包的路径。 有关详细信息，请参阅 安装 Gulp.js。

环境变量

在此字段中，如适用，请为 Node.js 可执行文件指定 环境变量。 点击字段右侧的 浏览 ，在打开的 环境变量 对话框中配置变量列表：

• 要定义新变量，请点击 ，并指定变量名称和值。

• 要放弃某个变量定义，请在列表中选择该变量并点击 。

• 准备就绪后，点击 确定。

变量定义会显示在 环境变量 只读字段中，并以分号分隔，例如：

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

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

• NODE_DISABLE_COLORS ：设置为 1 可在 REPL 中禁用颜色。

名称(N)

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

允许多个实例(U)

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

默认情况下，该选项处于禁用状态；当您在另一个实例仍在运行时启动此配置，PyCharm 会建议停止正在运行的实例并启动另一个实例。 当某个运行配置占用大量资源且没有充分理由运行多个实例时，这一设置非常有用。

存储为项目文件(S)

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

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

Alt+Insert

创建运行/调试配置。

Alt+Delete

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

Ctrl+D

创建所选运行/调试配置的副本。 请注意，您将创建默认配置的副本。

仅在您选择 临时配置 时才显示该按钮。 点击此按钮可将临时配置保存为永久配置。

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

要创建文件夹，请在某个类别中选择配置，点击 ，并指定文件夹名称。 如果只选中了某个类别，则会创建一个空文件夹。

然后，要将配置移入文件夹、在文件夹之间移动或移出文件夹，请使用拖动，或使用 和 按钮。

要移除分组，请选择一个文件夹并点击 。

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

Alt+Insert

点击此图标以添加下列可用任务之一：

• 启动Web 浏览器 ：选择此选项以启动浏览器。 在打开的对话框中，选择浏览器类型并提供起始 URL。 另外，指定是否要使用 JavaScript 调试器启动浏览器。

• 运行外部工具 ：选择运行外部应用程序。 在打开的对话框中，选择您要运行的一个或多个应用程序。 如果尚未在 PyCharm 中定义，请添加其定义。 有关详细信息，请参阅 外部工具 和 外部工具。

• 运行另一个配置 ：选择执行另一个运行/调试配置，并在其完成后再启动当前配置。 如果您想并行运行多个配置，请使用 复合运行/调试配置。

• 运行File Watcher ：选择此选项，使 PyCharm 应用所有当前处于活动状态的 文件监视器。

• 运行远程外部工具 ：添加一个 远程 SSH 外部工具。

• 运行Grunt 任务 ：选择此选项以运行 Grunt 任务。

  在打开的 Grunt 任务 对话框中，指定定义所需任务的 Gruntfile.js ，选择要执行的任务，并指定要传递给 Grunt 工具的参数。

  指定 Node.js 运行时的位置、要传递给它的参数以及 grunt-cli 包的路径。

• 运行 Gulp 任务 ：选择此选项以运行 Gulp 任务。

  在打开的 Gulp 任务 对话框中，指定定义所需任务的 Gulpfile.js ，选择要执行的任务，并指定要传递给 Gulp 工具的参数。

  指定 Node.js 运行时的位置、要传递给它的参数以及 gulp 包的路径。

• 运行 npm 脚本 ：选择此选项以执行 npm 脚本。

  在打开的 npm 脚本 对话框中，指定 npm 运行/调试配置设置。

• 编译TypeScript ：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。 在打开的 TypeScript 编译设置 对话框中，选中或清除 检查错误 复选框，以在检测到任何错误时配置编译器的行为：

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

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

• 生成CoffeeScript 源映射 ：选择此选项为您的 CoffeeScript 源文件生成源映射。 在打开的对话框中，指定您的 CoffeeScript 源文件的位置。

Alt+Delete

点击此图标可从列表中移除所选任务。

Enter

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

Alt+Up

Alt+Down

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

显示此页面

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

激活工具窗口

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

否则，如果清除了该复选框，则会隐藏工具窗口。 但是，在配置运行期间，您可以按 Alt+4 或 Alt+5 自行打开其相应的工具窗口。