Quarkus 运行配置

Quarkus 运行/调试配置定义了如何在IntelliJ IDEA中运行您的 Quarkus 应用程序。如果您的项目包含 Quarkus 依赖项，它会自动创建。此运行配置在开发模式下运行您的 Quarkus 应用程序，启用实时重载。

主要参数

条目	描述
名称(N)	在编辑或运行时，指定运行配置的名称以便快速识别。
运行于	选择您要运行配置的目标环境。除了在本地运行之外，您还可以选择通过 SSH 在远程机器上或在 Docker 容器中运行您的应用程序。有关更多信息，请参见运行目标。
存储为项目文件(S)	将运行配置设置保存到文件中，以便与其他团队成员共享。默认位置是 .idea/runConfigurations 。但是，如果您不想共享 .idea 目录，您可以将配置保存到项目内的任何其他目录。默认情况下，此选项是禁用的，IntelliJ IDEA 将运行配置设置存储在 .idea/workspace.xml 。
应用程序模块	请选择应用程序的根模块。

条目	描述
允许多个实例(U)	允许此运行配置的多个实例同时执行。默认情况下，此选项是禁用的，这意味着当您运行该配置时，其他活动的配置会话将终止。
环境变量(E)	点击打开环境变量对话框，您可以在其中创建变量并指定其值。
模拟终端(E)	在运行工具窗口模拟本地 Quarkus CLI。此参数目前仅在 Maven 项目中可用。

条目	描述
运行前不构建	无需启动构建过程即可立即运行应用程序。
虚拟机选项(V)	指定启动应用程序时传递给 Java 虚拟机的选项，例如， `-mx`、 `-verbose` 等。在指定 JVM 选项时，请遵循以下规则：使用空格来分隔各个选项。如果选项的值包含空格，请用双引号括起值或实际空格。如果选项的值中包含双引号，请使用反斜杠对双引号进行转义。您可以将环境变量值传递给自定义 Java 属性。 -Xmx1024m -Dspaces="some arg" -Dmy.prop=\"quoted_value\" -Dfoo=${MY_ENV_VAR} 在此字段中使用代码补全：开始输入标志的名称，IDE 会建议可用的命令行选项列表。这适用于 `-XX:` 和 `-X` 选项以及一些未由IntelliJ IDEA自动配置的标准选项，如 `-ea` ，但不适用于 `-cp` 或 `–release`。此字段中指定的 `-classpath` 选项将重写模块的类路径。

条目

描述

运行前不构建

无需启动构建过程即可立即运行应用程序。

虚拟机选项(V)

指定启动应用程序时传递给 Java 虚拟机的选项，例如， -mx、 -verbose 等。

在指定 JVM 选项时，请遵循以下规则：

-Xmx1024m -Dspaces="some arg" -Dmy.prop=\"quoted_value\" -Dfoo=${MY_ENV_VAR}

在此字段中使用代码补全：开始输入标志的名称，IDE 会建议可用的命令行选项列表。这适用于 -XX: 和 -X 选项以及一些未由IntelliJ IDEA自动配置的标准选项，如 -ea ，但不适用于 -cp 或 –release。

此字段中指定的 -classpath 选项将重写模块的类路径。

请指定在运行或调试工具窗口专用选项卡的控制台中显示的运行或调试应用程序时生成的日志文件。

条目	描述
运行配置文件	请指定要在应用程序中使用的配置文件。
添加实参(R)	将参数传递给您的应用程序。请使用与指定 VM options 相同的语法。

选择在启动所选运行/调试配置之前要执行的任务。默认情况下，将执行构建任务。

IntelliJ IDEA 还附带了 Quarkus 应用程序运行配置。当您从类中带有运行注释运行应用程序时，它会自动通过边框图标 @QuarkusMain 创建。

不同于 Quarkus 运行配置使用构建工具任务启动应用程序， Quarkus 应用程序使用 java 命令。

此运行配置几乎与 Application 运行配置相同；有关运行配置参数的说明，请参阅它。

2026年 1月 23日