运行/调试配置：Shell 脚本

启用 Shell 脚本插件

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

按下 Ctrl+Alt+S 打开设置，然后选择插件。
打开已安装选项卡，找到 Shell scripts 插件，并勾选插件名称旁的复选框。

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

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

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

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

项目	描述
脚本文本	输入要运行的命令文本。
工作目录	提供用于运行该命令的目录的绝对路径。
环境变量	如需在命令中使用，请指定环境变量。您可以点击打开环境变量窗口，在其中浏览并复制已有变量，或创建自己的变量。
在终端中执行	选中此复选框可在终端工具窗口中运行 shell 脚本。如果未选中此复选框，脚本将在运行工具窗口中运行。

常规设置

编辑运行配置（而非运行配置模板）时，您可以指定以下选项：

项目	描述
名称(N)	请为运行配置指定一个名称，以便在编辑或运行时快速识别。
允许多个实例(U)	允许并行运行此运行配置的多个实例。默认情况下此选项为禁用状态，当您启动此配置时，如果仍有其他实例正在运行，GoLand 会建议终止运行中的实例并启动新实例。此选项适用于占用大量资源并且没有充分理由并行运行多个实例的配置。当运行配置消耗大量资源，且没有充分理由同时运行多个实例时，此功能非常有用。
存储为项目文件(S)	将包含运行配置设置的文件保存下来，以便与其他团队成员共享。默认位置为 .idea/runConfigurations 。但是，如果您不希望共享 .idea 目录，您可以将配置保存到项目中的任何其他目录。默认情况下该选项处于禁用状态，GoLand 会将运行配置设置存储在 .idea/workspace.xml 。

项目

描述

名称(N)

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

允许多个实例(U)

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

默认情况下此选项为禁用状态，当您启动此配置时，如果仍有其他实例正在运行，GoLand 会建议终止运行中的实例并启动新实例。此选项适用于占用大量资源并且没有充分理由并行运行多个实例的配置。当运行配置消耗大量资源，且没有充分理由同时运行多个实例时，此功能非常有用。

存储为项目文件(S)

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

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

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

项	快捷键	说明
	`Alt+Insert`	创建一个运行／调试配置。
	`Alt+Delete`	删除所选运行／调试配置。请注意，无法删除默认配置。
	`Ctrl+D`	复制所选运行／调试配置。请注意，您可以复制默认配置。
		该按钮仅在您选择临时配置时显示。点击此按钮可将临时配置保存为永久配置。
		移动到新文件夹／创建新文件夹。您可以通过将配置放入文件夹中来对运行／调试配置进行分组。要创建文件夹，请在某一类别中选择配置，单击，并指定文件夹名称。如果只聚焦于某个类别，将创建一个空文件夹。然后，如需将配置移动至文件夹、文件夹之间或移出文件夹，可使用拖放方式或使用与按钮。要取消分组，请选择一个文件夹并单击。
		单击此按钮可按字母顺序对配置进行排序。

启动前

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

项	快捷键	说明
	`Alt+Insert`	单击该图标可添加以下可用任务之一：启动Web 浏览器：选择此选项可启动浏览器。在打开的对话框中，选择浏览器类型并提供起始 URL。还可以指定是否要使用 JavaScript 调试器启动浏览器。运行外部工具：选择此项以运行外部应用程序。在打开的对话框中，选择要运行的一个或多个应用程序。如果该应用尚未在 GoLand 中定义，请添加其定义。运行另一个配置：选择此项以执行另一个运行／调试配置，并在其结束后再启动当前配置。如果希望并行运行多个配置，请使用复合运行／调试配置。运行File Watcher ：选择此选项可让 GoLand 应用所有当前激活的文件监视器。运行远程外部工具：添加一个远程 SSH 外部工具。运行Grunt 任务：选择此选项以运行 Grunt 任务。在打开的 Grunt 任务对话框中，指定定义任务的 Gruntfile.js ，选择要执行的任务，并指定传递给 Grunt 工具的参数。指定 Node.js 解释器的位置、要传递的参数，以及 grunt-cli 包的路径。运行gulp 任务：选择此选项以运行 Gulp 任务。在打开的 Gulp 任务对话框中，指定定义任务的 Gulpfile.js ，选择要执行的任务，并指定传递给 Gulp 工具的参数。指定 Node.js 解释器的位置、要传递的参数，以及 gulp 包的路径。运行npm 脚本：选择此项以执行 npm 脚本。在打开的 NPM 脚本对话框中，指定 npm run/debug configuration settings。编译TypeScript ：选择此项以运行内置的 TypeScript 编译器，从而确保您对 TypeScript 代码所做的所有更改被反映到生成的 JavaScript 文件中。在打开的 TypeScript 编译设置对话框中，选中或取消选中检查错误复选框，以在检测到错误时配置编译器的行为：如果选中检查错误复选框，编译器将显示所有错误并且运行配置不会启动。如果未选中检查错误复选框，编译器将显示所有检测到的错误，但仍会启动运行配置。运行Go 命令：选择此项以在运行程序之前执行 Go 命令。例如，您可以运行 `go generate` 以在编译之前生成源代码。在编辑Go 命令任务对话框中，您可以使用自动补全。自动完成支持以下命令 `generate`、 `vet`、 `test -i`。您可以使用自己的命令。断开数据源：如果您希望在运行/调试配置开始之前断开与数据源的连接，请选择此选项。
	`Alt+Delete`	单击此图标可将所选任务从列表中移除。
	`Enter`	单击此图标可编辑所选任务。在打开的对话框中进行必要的更改。
	`Alt+Up` `Alt+Down`	单击这些图标可将所选任务在列表中上移或下移一行。将按任务在列表中出现的顺序执行。
显示此页面		选中此复选框可在实际启动运行/调试配置之前显示其设置。
激活工具窗口		默认情况下，此复选框已被选中，启动运行/调试配置时会打开 Run 或 Debug 工具窗口。否则，如果未选中该复选框，则工具窗口将被隐藏。不过，在配置运行期间，您可以按 `Alt+4` 或 `Alt+5` 自行打开相应的工具窗口。

最后修改日期： 2025年 9月 26日