# Quarkus

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **TL;DR**
> 必需插件：  Quarkus （捆绑）

[Quarkus](https://quarkus.io/) 是一个面向 Kubernetes 的 Java 框架，主要用于构建微服务。

IntelliJ IDEA 提供以下内容：

* 基于 [code.quarkus.io](https://code.quarkus.io/) 的专用项目创建向导。

* [专用于 Quarkus 应用程序的运行配置](quarkus-run-configuration.html)。

* 特定于 Quarkus 的编码辅助。

* 与 [Beans](beans-tool-window.html) 和 [Endpoints](endpoints-tool-window.html) 工具窗口集成。

Procedure: 创建一个新的 Quarkus 项目

1. 启动 IntelliJ IDEA。

如果打开欢迎屏幕，请点击   新建项目  。

否则，请在主菜单中转到  `文件 | 新建 | 项目…` 。

2. 从左侧窗格中选择   Quarkus  。

* 点击 ![配置图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) 以输入要使用的服务的 URL，或保留默认值。

* 指定项目的名称和位置，并配置项目元数据：选择一种语言、一种构建工具，并指定工件 ID。

* 从 JDK 列表中选择您想在项目中使用的 [JDK](sdk.html#jdk)。 * 如果已在计算机上安装 JDK，但未在 IDE 中定义，请选择 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.nodes.jdk.png) 从磁盘添加 JDK… 并指定 JDK 主目录的路径。​ * 如果您的计算机上没有必要的 JDK，请选择 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.download.svg) 下载 JDK 。

* 请选择 添加示例代码 选项以与项目一起创建名为 `ExampleResource` 的 REST 端点。

![全新 Quarkus 项目向导](https://resources.jetbrains.com/help/img/idea/2026.3/quarkus-new-project.png)

点击   下一步  。

3. 在向导的下一步中，从   扩展程序   列表中选择必要的选项，然后点击   创建  。

如果您在   添加示例代码  向导中选择了   新建项目  选项，生成的项目将包含一个名为  `ExampleResource` 的 REST endpoint，代码如下：

```JAVA
package com.example;

import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;

@Path("/hello")
public class ExampleResource {

    @GET
    @Produces(MediaType.TEXT_PLAIN)
    public String hello() {
        return "Hello from RESTEasy Reactive";
    }
}

```

您可以打开 [端点](endpoints-tool-window.html) 工具窗口（  `视图 | 工具窗口 | 端点` ），查看此端点：

![Endpoints 工具窗口中的 ExampleResource 端点](https://resources.jetbrains.com/help/img/idea/2026.3/quarkus-hello-endpoint.png)

Procedure: 运行 Quarkus 应用程序

IntelliJ IDEA 创建一个   Quarkus  运行配置，执行必要的 Maven 目标或 Gradle 任务。

* 在主工具栏中选择   Quarkus   运行配置，然后点击 ![运行图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg) 或按 `Shift+F10` (Windows), `⌃ R` (macOS), `⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ R` (macOS System Shortcuts), `Shift+F10` (XWin), `Shift+F10` (GNOME), `Shift+F10` (KDE), `Shift+F10` (Emacs), `Shift+F10` (Sublime Text), `Shift+F10` (Sublime Text (macOS)), `Ctrl+F5` (Visual Studio), `⌃ F5` (Visual Studio (macOS)), `F6` (NetBeans), `Alt+Shift+X` (Eclipse), `⌘ ⇧ F11` (Eclipse (macOS))。

或者，您可以按 `Alt+Shift+F10` (Windows), `⌃ ⌥ R` (macOS), `⌥ ⇧ F10` (IntelliJ IDEA Classic (macOS)), `⌃ ⌥ R` (macOS System Shortcuts), `Alt+Shift+F10` (XWin), `Alt+Shift+F10` (GNOME), `Alt+Shift+F10` (KDE), `Alt+Shift+F10` (Emacs), `Alt+Shift+F10` (Sublime Text), `⌃ ⌥ R` (Sublime Text (macOS)), `Ctrl+Alt+Shift+R` (Visual Studio), `⌘ ⌥ ⇧ R` (Visual Studio (macOS)), `Alt+Shift+F10` (NetBeans), `Alt+Shift+F10` (Eclipse), `⌃ ⌥ R` (Eclipse (macOS)) 并选择所需的运行配置。

如果成功，应会在   运行   工具窗口中看到输出日志。

![Quarkus 应用程序在运行工具窗口中运行](https://resources.jetbrains.com/help/img/idea/2026.3/quarkus-run-tool-window.png)

默认情况下，应用程序会在 [http://localhost:8080](http://localhost:8080) 上启动。 请在网络浏览器中打开此地址查看 Quarkus 主页：

![Quarkus 应用程序起始页](https://resources.jetbrains.com/help/img/idea/2026.3/quarkus-start-page.png)

如果您打开 [http://localhost:8080/hello](http://localhost:8080/hello) 端点，您将看到字符串  `来自 RESTEasy Reactive 的问候` 。

默认配置会在开发模式下运行您的 Quarkus 应用程序，该模式启用后台编译。 例如，您可以将  `hello()`  方法在  `ExampleResource`  类中返回的字符串更改为  `来自修改后的 Quarkus 端点的问候` ，然后您将在刷新 [http://localhost:8080/hello](http://localhost:8080/hello) 后看到这个新字符串，而无需重新启动您的应用程序。

Procedure: 打开 Quarkus Dev UI

您可以直接在 IDE 中打开 [Quarkus Dev UI](https://quarkus.io/guides/dev-ui)。

1. [运行 Quarkus 应用程序](#run-app)。

2. 在   运行   工具窗口中，点击 ![Quarkus 图标](https://resources.jetbrains.com/help/img/idea/2026.3/quarkus.icons.quarkus.svg) (   打开 Quarkus Dev UI  )。

这将在一个新的编辑器标签中打开 Quarkus Dev UI。

![Quarkus Dev UI](https://resources.jetbrains.com/help/img/idea/2026.3/quarkus_dev_ui.png)

Procedure: 向现有 Quarkus 项目添加扩展

[Quarkus extensions](https://code.quarkus.io/) 是项目依赖项的预配置集合。

当您使用 IntelliJ IDEA 创建一个新的 Quarkus 项目时，您可以在 [专用的新建项目向导](#new_microservice_project)中添加扩展。 您还可以使用构建文件中的   添加扩展   内嵌提示将它们添加到现有项目中。

1. 打开您的  `pom.xml`  文件或  `build.gradle(.kts)`  文件。

2. 在  `dependencies`  块中，点击 ![Quarkus 编辑扩展](https://resources.jetbrains.com/help/img/idea/2026.3/quarkus.icons.quarkusInlay.svg)   添加扩展  。

![Quarkus 编辑扩展内嵌提示](https://resources.jetbrains.com/help/img/idea/2026.3/quarkus_edit_extensions.png)

3. 在打开的   添加扩展   对话框中，选择您想要添加的扩展。

![Quarkus 编辑扩展对话框](https://resources.jetbrains.com/help/img/idea/2026.3/quarkus_edit_extensions_dialog.png)

将会相应地修改您的构建文件。 通过这种方式添加依赖项时，IntelliJ IDEA 会考虑您的 Quarkus 版本，免去您担心兼容依赖项版本的麻烦。

您可以在 IDE 设置（ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))）中的  `编辑器 | 内嵌提示 | 其他`  内，在   Groovy  、   Kotlin   和   XML   下禁用或启用此嵌入提示。

Procedure: 快速创建与数据库的连接

借助   数据库工具和 SQL   插件，IntelliJ IDEA 可用于创建和管理 [数据库连接](connecting-to-a-database.html)。

在 Quarkus 项目中，您可以立即从应用程序属性文件创建它。

1. 打开一个  `application.properties`  或  `application.yml`  文件。 如果它包含与数据源相关的属性，数据源图标 ![数据源图标](https://resources.jetbrains.com/help/img/idea/2026.3/javaee-persistence-impl.icons.expui.add-db-from-config.svg) 将显示在边距中。

2. 点击 ![数据源图标](https://resources.jetbrains.com/help/img/idea/2026.3/javaee-persistence-impl.icons.expui.add-db-from-config.svg)。 这将打开数据源创建表单，并根据配置文件中的数据填充数据源形参（例如 URL、用户名或数据库名称）。

如果数据源已配置，则会显示数据源图标 ![](https://resources.jetbrains.com/help/img/idea/2026.3/database-plugin.icons.expui.dbms.svg)。 点击它以在   数据库   工具窗口中打开数据源。

![创建数据源窗口](https://resources.jetbrains.com/help/img/idea/2026.3/quarkus_create_datasource_from_properties.png)

以下是此操作可用的数据库列表：

* Amazon Redshift

* Apache Cassandra

* Apache Derby 数据库

* Couchbase

* H2

* HSQLDB

* IBM Db2

* MariaDB

* Microsoft SQL 服务器

* MongoDB

* MySQL

* Oracle Database

* PostgreSQL

* Redis

* SQLite

* Sybase

有关数据源形参的更多详细信息，请参阅 [数据源](managing-data-sources.html)。

Procedure: 调试 Quarkus 应用程序

要调试正在运行的 Quarkus 应用程序， [附加调试器](attach-to-process.html#attach-to-local)到它。

1. 请在您的代码中设置一个 [breakpoint](using-breakpoints.html)。

例如，您可以在  `return`  语句所在的  `hello()`  方法的行上设置它。

2. 在主菜单中，前往  `运行 | 附加到进程…` 。

3. 从 Java 进程列表中选择 您的 Quarkus 应用 的进程。

如果成功，IntelliJ IDEA 将打开   调试  工具窗口，并建立调试器连接。

4. 现在打开 [http://localhost:8080/hello](http://localhost:8080/hello) 调用  `hello()`  方法。 调试器应在返回 greeting 字符串之前停在断点处。

5. 在   调试   工具窗口中，点击 ![“继续”按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.resume.svg) `F9` (Windows), `⌘ ⌥ R` (macOS), `F9` (IntelliJ IDEA Classic (macOS)), `⌃ \` (macOS System Shortcuts), `F9` (XWin), `F9` (GNOME), `F9` (KDE), `F9` (Emacs), `F9` (Sublime Text), `F9` (Sublime Text (macOS)), `F5` (Visual Studio), `F5` (Visual Studio (macOS)), `F5` (NetBeans), `F8` (Eclipse), `F8` (Eclipse (macOS)) 继续执行并将字符串返回到 web 浏览器。

要分离调试器，请点击 ![停止按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.stop.svg) `Ctrl+F2` (Windows), `⌘ F2` (macOS), `⌘ F2` (IntelliJ IDEA Classic (macOS)), `⌃ ⇧ .` (macOS System Shortcuts), `Ctrl+F2` (XWin), `Ctrl+F2` (GNOME), `Ctrl+2` (KDE), `Ctrl+F2` (Emacs), `Ctrl+F2` (Sublime Text), `Ctrl+F2` (Sublime Text (macOS)), `Shift+F5` (Visual Studio), `⇧ F5` (Visual Studio (macOS)), `Shift+F5` (NetBeans), `Ctrl+F2` (Eclipse), `⌘ F2` (Eclipse (macOS))。 这不会停止实际的应用程序进程，只是断开调试器与其的连接。

## Qute

[Qute](https://quarkus.io/guides/qute) 是 Quarkus 的一个模板引擎。 IntelliJ IDEA 提供对 Qute 的支持，例如代码补全、语法高亮、查找用法等。

要将文件识别为 Qute 模板，它们必须具有  `.html` 、  `.txt` 、  `.json`  或  `.yaml`  扩展名，并且必须位于  `src/main/resources/templates`  文件夹中。 此外，  `*.qute.*`  可以在扩展名前使用，例如  `hello.qute.html` 。

IntelliJ IDEA 提供的功能包括：

* 为 Qute 语法提供编码辅助。 ![Qute 语法补全](https://resources.jetbrains.com/help/img/idea/2026.3/quarkus_qute_syntax_completion.png)

* 为已声明变量的名称和方法提供智能提示（ `Ctrl+Space` (Windows), `⌃ Space` (macOS), `⌃ Space` (IntelliJ IDEA Classic (macOS)), `⌃ Space` (macOS System Shortcuts), `Ctrl+Space` (XWin), `Ctrl+Space` (GNOME), `Ctrl+Space` (KDE), `Alt+/` (Emacs), `Ctrl+Space` (Sublime Text), `⌃ Space` (Sublime Text (macOS)), `Ctrl+Space` (Visual Studio), `⌃ Space` (Visual Studio (macOS)), `Ctrl+Space` (NetBeans), `Ctrl+Space` (Eclipse), `⌃ Space` (Eclipse (macOS))），并导航到它们的声明位置（ `Ctrl+B` (Windows), `⌘ B` (macOS), `⌘ B` (IntelliJ IDEA Classic (macOS)), `⌘ B` (macOS System Shortcuts), `Ctrl+B` (XWin), `Ctrl+B` (GNOME), `Ctrl+B` (KDE), `Ctrl+Alt+G` (Emacs), `F12` (Sublime Text), `F12` (Sublime Text (macOS)), `F12` (Visual Studio), `F12` (Visual Studio (macOS)), `Ctrl+B` (NetBeans), `F3` (Eclipse), `F3` (Eclipse (macOS))）。 ![Qute 变量补全](https://resources.jetbrains.com/help/img/idea/2026.3/quarkus_qute_variable_completion.png)

* 输入 实时模板：输入 `q` 并按 `Ctrl+Space` (Windows), `⌃ Space` (macOS), `⌃ Space` (IntelliJ IDEA Classic (macOS)), `⌃ Space` (macOS System Shortcuts), `Ctrl+Space` (XWin), `Ctrl+Space` (GNOME), `Ctrl+Space` (KDE), `Alt+/` (Emacs), `Ctrl+Space` (Sublime Text), `⌃ Space` (Sublime Text (macOS)), `Ctrl+Space` (Visual Studio), `⌃ Space` (Visual Studio (macOS)), `Ctrl+Space` (NetBeans), `Ctrl+Space` (Eclipse), `⌃ Space` (Eclipse (macOS)) 查看可用的 Qute 实时模板。 ![Qute 代码模板](https://resources.jetbrains.com/help/img/idea/2026.3/quarkus_qute_live_templates.png) 要配置 Qute [动态模板](using-live-templates.html)或创建新的模板，请打开 IDE 设置( `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)))，然后转到 `编辑器 | 实时模板 | Qute` 。

Procedure: 导航至 Qute 模板

IntelliJ IDEA 允许迅速从代码中引用的位置导航到 Qute 模板。

1. 打开引用 Qute 模板的代码部分。

这可以是一个带注释的类  `@CheckedTemplate` ，一个实现了  `io.quarkus.qute.TemplateInstance` 的记录或一个注入的模板。

2. 在边栏中，点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.fileTypes.anyType.svg) (   导航至 Qute 模板  )。

![导航到 Qute](https://resources.jetbrains.com/help/img/idea/2026.3/quarkus_navigate_to_template.png)

如果相关的 Qute 模板存在，它将会在新的编辑器标签页中打开。 IntelliJ IDEA 会考虑  `@Location`  注解和  `basePath`  属性来确定模板位置。

