DataGrip 2025.2 Help

运行/调试配置

DataGrip 使用运行/调试配置来运行、调试和测试您的代码。 每个配置是一组命名的启动属性,用于定义要执行的内容以及应使用的参数和环境。

有两种 运行 配置:

  • 临时 — 每次您从上下文菜单中选择 运行 <item_name> 时创建。 要调用上下文菜单,请右键点击一个对象或区域。

  • 永久—由模板显式创建或通过保存临时配置创建。 永久配置将作为您项目的一部分,直到您删除它们。

每当您运行、调试或测试代码时,DataGrip 要么使用现有的永久运行/调试配置,要么创建一个新的临时配置。

永久配置的图标是不透明的,而临时配置的图标是半透明的。 配置图标上的红色叉号表示配置设置中存在错误。

临时配置的最大数量为 5。 添加新版本时,旧版本会被自动删除。 如有必要,您可以在 设置 | 高级设置 | 运行/调试 | 临时配置限制 中增加此限制。

永久配置和临时配置有不同的图标

创建永久运行/调试配置

DataGrip 提供以下方法来创建永久运行/调试配置:

将临时配置保存为永久配置

  • 在 运行 配置切换器中选择一个临时配置,单击 / 并选择 保存配置

    保存临时运行配置
  • 或者,在“运行/调试配置”对话框中选择一个临时配置,然后点击工具栏上的 保存

DataGrip 为不同的语言、工具和框架提供运行/调试配置 模板。 可用模板的列表会因已安装和启用的 plugins 而有所不同。

从模板创建运行/调试配置

  1. 转到 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后 0

  2. 点击 运行 | 编辑配置

  3. 运行/调试配置 对话框中,单击 添加新配置 图标(新建配置图标 )并选择 数据库脚本

    • 目标数据源/架构 :您要运行数据库脚本的数据库或架构。 此设置依赖于方言。

      如果您选择一个数据源作为目标,DataGrip 会显示将运行脚本的模式。 这是默认模式。

    • 脚本文本 :您想要运行的脚本。

    • 脚本文件 :需要运行的 SQL 文件。 若要添加文件,请点击 Add 按钮("添加"按钮 )并导航到您想要运行的文件。 如果脚本包含模式切换,您将看到警告 (警告)。

    有关 数据库脚本 配置类型设置的更多信息,请参阅 数据库脚本

  4. 如果您希望允许同时运行多个配置实例,请选择 允许多个实例(U)

  5. 启动前 部分中,定义在启动应用程序之前是否要执行任何特定操作,例如启动一个 外部工具或断开与数据源的连接。

    在运行脚本之前断开与数据源的连接
  6. 您可以立即运行该配置,也可以保存配置以便稍后运行。

    • 要保存运行配置以供稍后运行,请单击 确定

    • 若要立即运行此配置,请点击 运行

    使用运行/调试配置运行脚本文本
    使用运行/调试配置运行脚本文件

启动前

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

项目

快捷方式

描述

"添加"按钮

Alt+Insert

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

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

  • 运行外部工具 :选择运行外部应用程序。 在打开的对话框中,选择一个或多个您想要运行的应用程序。 如果它在 DataGrip 中尚未定义,请添加其定义。 如需更多信息,请参阅 外部工具外部工具

  • 运行另一个配置 :选择执行另一个运行/调试配置,并等待其完成后再开始当前配置。 如果您想并行运行多个配置,请使用 复合运行/调试配置

  • 断开数据源 :如果您希望在运行/调试配置运行之前中断与数据源的连接,请选择此选项。

"移除"按钮

Alt+Delete

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

编辑

Enter

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

方法向上

方法 down

Alt+Up

Alt+Down

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

显示此页面

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

激活工具窗口

默认情况下,此复选框处于选中状态,并且在您启动 run/debug 配置时, RunDebug 工具窗口会打开。

否则,如果复选框未选中,工具窗口将被隐藏。 但是,在配置运行时,您可以通过按 Alt+4Alt+5 自行打开相应的工具窗口。

启动运行配置

您可以使用快捷键或运行小部件启动现有的运行配置。

  • 如果运行配置已在 Run widget中选择,请单击其旁边的 或按 Shift+F10

    运行小部件旁的“Run”按钮
  • 如果您想选择另一个运行配置,请单击 Run widget。 在打开的菜单中,单击您想启动的运行配置旁的

    运行小部件菜单中运行配置旁的“Run”按钮
  • 按下 Alt+Shift+F10。 在打开的菜单中,单击您想启动的运行配置。

共享运行/调试配置

您可能希望共享您的 运行 配置,以便您的团队成员可以使用相同的配置运行应用程序,或者使他们能够远程附加到您正在运行的进程。

DataGrip 提供了一种机制,可以将您的 运行 配置存储为项目文件并通过 VCS 共享。 当您希望将配置作为文件发送给其他人、创建运行/调试配置的本地备份或从文件导入它们时,也可以使用相同的机制。

传统 .ipr -based 项目不支持单独的 运行 配置。 对于传统项目,您只能通过将 .ipr 文件添加到 VCS 来一次性共享所有配置。

  1. 转到 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后 0

  2. 请选择您要共享的 运行 配置,启用 存储为项目文件(S) 选项,并指定配置文件的存储位置。

    您可以配置任何位置,除非需要与 DataGrip 2019.3 及更早版本兼容。 为了与这些版本兼容,请将文件存储在建议的位置。

    存储为项目文件框
  3. (可选)如果将 .idea 目录添加到 VCS 忽略文件中,那么 .idea/runConfigurations 子文件夹也将被忽略。 如果项目使用 Git,您可以共享 .idea/runConfigurations 并保留 .idea 被忽略,通过修改 .gitignore 如下:

    /.idea/* !/.idea/runConfigurations

运行/调试配置模板

所有运行/调试配置都基于模板,这些模板实现了启动逻辑,定义参数列表及其默认值。 安装中预定义了 可用模板列表 ,只能通过 插件进行扩展。 但是,您可以编辑每个模板中的默认参数值,以便于新运行/调试配置的设置。

配置模板的默认值

  1. 转到 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后 0

  2. 在 运行 配置对话框的左侧窗格中,点击 编辑配置模板…

  3. 在打开的 运行/调试配置模板 对话框中,选择一个配置类型。

  4. 请指定所需的默认参数,然后点击 确定 以保存模板。

    运行配置模板

运行/调试配置文件夹

当有许多相同类型的 运行 配置时,您可以将它们分组到文件夹中以便于访问。

运行配置的文件夹

为运行配置创建文件夹

  1. 转到 运行 | 编辑配置。 或者,按 Alt+Shift+F10 ,然后 0

  2. 运行/调试配置 对话框中,选择配置类型并在工具栏上点击 新建文件夹图标。 已创建一个新的空文件夹用于所选类型。

  3. 请在右侧的文本框中指定文件夹名称或接受默认名称。

  4. 选择所需的 运行 配置并将它们移动到目标文件夹下。

  5. 应用这些更改。 如果一个文件夹是空的,它将不会被保存。

为运行配置创建新文件夹

当您不再需要文件夹时,可以将其删除 Delete。 此文件夹下的 运行 配置将被移动到相应 运行 配置类型的根目录下。

运行多个配置

  • 要同时运行或调试多个任务,请打开工具栏中的运行小部件菜单,并在按住 Ctrl 键的同时选择相应的运行/调试配置。

    %alt

有关使用单个运行/调试配置启动多个任务的信息,请参阅 运行多个目标

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