PhpStorm 2021.3 Help

运行/调试配置:Gulp.js

运行 | 编辑配置 | 添加新配置 | Gulp.js

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

在你开始前

  1. 下载并安装Node.js。

  2. 按照安装 Gulp.js中的说明安装gulp包。

Gulp.js 特定的配置设置

物品

描述

吞吐文件

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

任务

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

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

  • 要运行多个任务,请在文本框中键入它们的名称,并使用空格作为分隔符。

论据

在此文本框中,指定要执行的任务的参数。使用格式--<parameter_name> <parameter_value>,例如:--env development. 从Gulp 官方网站了解更多信息。

节点解释器

在此字段中,指定要使用的 Node.js 解释器。这可以是本地 Node.js 解释器Windows Subsystem for Linux 上的Node.js。

节点选项

在此文本框中,键入要传递给 Node.js 可执行文件的特定于 Node.js 的命令行选项。有关详细信息,请参阅节点参数

默认配置中,--harmony在此文本框中键入以让 PhpStorm 根据用ECMA6编写的Gulpfile.js构建任务树。

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

吞咽包

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

环境变量

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

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

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

  • 点击OK,准备就绪

变量的定义以分号作为分隔符显示在环境变量只读字段中,例如:

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

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

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

常用设置

当您编辑运行配置(但不是运行配置模板)时,您可以指定以下选项:

姓名

为运行/调试配置指定一个名称,以便在编辑或运行配置时快速识别它,例如,从运行弹出窗口Alt+Shift+F10中。

允许并行运行

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

默认情况下,它是禁用的,当您在另一个实例仍在运行时启动此配置时,PhpStorm 建议停止正在运行的实例并启动另一个实例。当运行/调试配置消耗大量资源并且没有充分理由运行多个实例时,这很有帮助。

存储为项目文件

使用运行配置设置保存文件以与其他团队成员共享。默认位置是.idea/runConfigurations。但是,如果您不想共享.idea目录,您可以将配置保存到项目中的任何其他目录。

默认情况下,它被禁用,并且 PhpStorm 将运行配置设置存储在.idea/workspace.xml中。

工具栏

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

物品

捷径

描述

添加按钮

Alt+Insert

创建运行/调试配置。

删除按钮

Alt+Delete

删除选定的运行/调试配置。请注意,您不能删除默认配置。

复制

Ctrl+D

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

保存配置

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

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

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

要创建文件夹,请选择类别中的配置,单击文件夹,然后指定文件夹名称。如果仅关注一个类别,则会创建一个空文件夹。

然后,要将配置移入文件夹、文件夹之间或移出文件夹,请使用拖动或提升下移按钮。

要删除分组,请选择一个文件夹并单击删除配置

排序配置

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

发射前

在此区域中,您可以指定在开始选定的运行/调试配置之前要执行的任务。任务按照它们在列表中出现的顺序执行。

物品

捷径

描述

添加按钮

Alt+Insert

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

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

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

  • 运行另一个配置:选择执行另一个运行/调试配置。在打开的对话框中,选择要运行的配置。

  • 运行文件观察器:选择此选项让 PhpStorm 应用所有当前活动的文件观察器。

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

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

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

  • 运行 Phing 目标:添加此任务以在运行或调试之前执行指定的Phing目标。要指定 Phing 目标,请单击浏览 浏览按钮并在打开的对话框中选择所需的目标。

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

删除按钮

Alt+Delete

单击此图标可从列表中删除选定的任务。

编辑

Enter

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

方法向上/方法向下

Alt+Up/Alt+Down

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

显示此页面

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

激活工具窗口

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

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

最后修改:2021 年 12 月 20 日