运行/调试配置：Shell 脚本

启用 Shell 脚本插件

此功能依赖于 Shell scripts插件，该插件默认在 IntelliJ IDEA 中捆绑并启用。如果相关功能不可用，请确保您没有禁用插件。

按 Ctrl+Alt+S 打开设置，然后选择插件。
打开已安装标签，找到 Shell 脚本插件，并选中插件名称旁的复选框。

使用此对话框配置运行 shell 脚本。有关在 IntelliJ IDEA 中使用 shell 脚本的更多信息，请参阅 Shell 脚本。

对话框中的参数集取决于您在执行下选择的选项：

脚本文件（运行脚本文件的配置）
脚本文本（运行单个命令的配置）

条目	描述
脚本路径	请提供 shell 脚本文件的路径。请手动输入路径或点击并在打开的对话框中选择路径。
脚本选项	请指定启动时要传递给脚本的选项。
工作目录	请提供运行脚本的目录的绝对路径。
环境变量	如果您的脚本中需要使用环境变量，请进行指定。您可以点击以打开环境变量窗口，在那里您可以浏览和复制现有变量或创建自己的变量。
解释器路径	请提供运行脚本的解释器路径。请手动输入路径或点击并在打开的对话框中选择路径。
解释器选项	指定您要传递给脚本解释器的选项。

条目	描述
脚本文本	请输入要运行的命令文本。
工作目录	请提供要运行该命令的目录的绝对路径。
环境变量	如在命令中需要环境变量，请指定。您可以点击以打开环境变量窗口，在那里您可以浏览和复制现有变量或创建自己的变量。

通用设置

当您编辑运行配置（但不是运行配置模板）时，您可以指定以下选项：

条目	描述
名称(N)	在编辑或运行时，指定运行配置的名称以便快速识别。
允许多个实例(U)	允许并行运行此运行配置的多个实例。默认情况下，它是禁用的，当您在另一个实例仍在运行时启动此配置，IntelliJ IDEA 建议停止正在运行的实例并启动另一个。当一个运行配置消耗大量资源且没有充分理由运行多个实例时，这会很有帮助。
存储为项目文件(S)	将运行配置设置的文件保存下来，与其他团队成员共享。默认位置是 .idea/runConfigurations 。但是，如果您不想共享 .idea 目录，您可以将配置保存到项目内的任何其他目录。默认情况下，它是禁用的，并且 IntelliJ IDEA 将运行配置设置存储在 .idea/workspace.xml 。

条目

描述

名称(N)

在编辑或运行时，指定运行配置的名称以便快速识别。

允许多个实例(U)

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

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

存储为项目文件(S)

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

默认情况下，它是禁用的，并且 IntelliJ IDEA 将运行配置设置存储在 .idea/workspace.xml 。

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

条目	快捷键	描述
	`Alt+Insert`	创建运行/调试配置。
	`Alt+Delete`	删除所选的运行/调试配置。请注意，您不能删除默认配置。
	`Ctrl+D`	创建所选运行/调试配置的副本。请注意，您正在创建默认配置的副本。
		只有当您选择了 temporary configuration时，按钮才会显示。点击此按钮将临时配置保存为永久配置。
		移动到新文件夹／创建新文件夹。您可以通过将它们放入文件夹来分组运行/调试配置。要创建文件夹，请选择类别中的配置，点击，并指定文件夹名称。如果只有一个类别处于焦点，则会创建一个空文件夹。然后，若要将配置移动到文件夹中、文件夹之间或从文件夹中移出，请使用拖放或与按钮。要取消分组，请选择一个文件夹并点击。
		点击此按钮以按字母顺序排列配置。

启动前

在此区域，您可以指定在启动所选的运行/调试配置之前需要执行的任务。任务将按其在列表中出现的顺序执行。

条目	快捷键	描述
	`Alt+Insert`	点击此图标以添加以下可用任务之一：启动Web 浏览器：选择此选项以启动浏览器。在打开的对话框中，选择浏览器类型并提供起始 URL。此外，指定是否希望浏览器与 JavaScript 调试器一起启动。运行外部工具：选择运行外部应用。在打开的对话框中，选择您想要运行的一个或多个应用程序。如果它在 IntelliJ IDEA 中尚未定义，请添加其定义。如需更多信息，请参阅外部工具和外部工具设置。运行另一个配置：选择执行另一个运行/调试配置，并等待其完成后再启动当前配置。如果您想并行运行多个配置，请使用 compound run/debug configuration。构建：选择编译指定的模块。 Build Module命令将会被执行。如果在编译过程中发生错误，IntelliJ IDEA 将不会尝试启动运行/调试配置。构建项目：选择编译整个项目。 Build Project 命令将被执行。如果在编译过程中发生错误，IntelliJ IDEA 将不会尝试启动运行/调试配置。构建，不检查错误：与构建选项相同，但 IntelliJ IDEA 将会尝试启动运行/调试配置，而不考虑编译结果。构建物：选择此选项以构建一个或多个构件。在打开的对话框中，选择应构建的 artifact。运行Grunt 任务：选择此选项以运行 Grunt 任务。在打开的 Grunt 任务对话框中，指定定义所需任务的 Gruntfile.js ，选择要执行的任务，并指定传递给 Grunt 工具的参数。指定 Node.js 解释器的位置、传递给它的参数以及 grunt-cli 包的路径。运行gulp 任务：选择此选项以运行 Gulp 任务。在打开的 Gulp 任务对话框中，请指定定义所需任务的 Gulpfile.js ，选择要执行的任务，并指定传递给 Gulp 工具的参数。指定 Node.js 解释器的位置、传递给它的参数以及 gulp 包的路径。运行 Maven Goal ：选择此选项以运行一个 Maven 目标。在打开的对话框中，选择要运行的目标。运行npm 脚本：选择此选项以执行 npm script。在打开的 NPM 脚本对话框中，指定 npm 运行/调试配置设置。编译TypeScript ：选择运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改都反映在生成的 JavaScript 文件中。在打开的 TypeScript 编译设置对话框中，选择或清除检查错误复选框，以配置在检测到任何错误时编译器的行为：如果选中检查错误复选框，编译器将显示所有错误，运行配置将不会启动。如果取消选中检查错误复选框，编译器将显示所有检测到的错误，但仍会启动运行配置。将文件上传到远程主机：选择此选项以根据默认服务器访问配置自动上传应用程序文件到服务器。运行远程外部工具：添加一个远程 SSH 外部工具。断开数据源：如果您希望在运行/调试配置运行之前中断与数据源的连接，请选择此选项。
	`Alt+Delete`	点击此图标以从列表中删除所选任务。
	`Enter`	点击此图标以编辑所选任务。在打开的对话框中进行必要的更改。
	`Alt+Up` `Alt+Down`	点击这些图标可以将所选任务在列表中上下移动一行。任务按照它们在列表中出现的顺序执行。
显示此页面		选中此复选框，以在实际启动运行/调试配置之前显示运行/调试配置设置。
激活工具窗口		默认情况下，将选中此复选框，启动运行/调试配置时将打开 Run 或 Debug 工具窗口。否则，如果复选框被清除，工具窗口将被隐藏。但是，当配置运行时，您可以通过按 `Alt+4` 或 `Alt+5` 自行打开相应的工具窗口。

最后修改日期： 2025年 4月 24日

运行/调试配置：Shell 脚本

启用 Shell 脚本 插件

通用设置

工具栏

启动前

启用 Shell 脚本插件