quarkusio / quarkus

#12

15,6913,189+4 todayJava

Quarkus：超音速亚原子Java框架

Quarkus 是一个专为云原生和容器化环境设计的 Java 框架，旨在显著提升 Java 应用的启动速度和运行效率。它通过将更多工作提前到编译期完成，使得应用在容器中能够以极小的内存占用快速启动，非常适合需要快速伸缩的微服务架构和 Kubernetes 环境。该框架同时支持传统的 JVM 模式和编译为原生可执行文件，后者尤其适合资源受限的场景。Quarkus 统一了命令式与响应式编程模型，并集成了多种主流标准与库（如 JAX-RS、Hibernate、Eclipse MicroProfile），让开发者能够高效构建从轻量级微服务到大型单体应用的各种项目，兼顾开发体验与生产性能。

📊 项目信息

语言: Java
Stars: ⭐ 15,691
Forks: 3,189
今日新增: +4
排名: #12
收录: 语言榜
趋势日期: 2026年5月27日
最后推送: 2026/5/27

🏷️ 标签

cloud-nativehacktoberfestjavakubernetesreactive

Quarkus 5分钟快速开始

Quarkus是一个超音速亚原子Java框架，专为云原生和容器环境设计，快速启动并运行你的第一个应用。

🖥️ 操作系统

macOSWindowsLinux

⚙️ 运行环境

Java11或更高

🔧 工具

Maven— 构建工具

📝 操作步骤

创建Quarkus项目

使用Maven命令生成一个简单的Quarkus项目。

创建名为my-quarkus-app的项目，包含REST API扩展

$ mvn io.quarkus.platform:quarkus-maven-plugin:3.6.0:create -DprojectGroupId=com.example -DprojectArtifactId=my-quarkus-app -Dextensions='resteasy-reactive'

✓预期输出：BUILD SUCCESS 表示项目创建成功。

💡确保Maven和Java已正确安装并配置环境变量。

进入项目目录

切换到新创建的项目文件夹。

进入项目根目录

$ cd my-quarkus-app

✓预期输出：命令行提示符显示当前路径为my-quarkus-app。

💡如果路径错误，请检查上一步的输出确认项目名称。

启动开发模式

运行Quarkus开发服务器，支持热重载。

在Unix/Linux/macOS上启动；Windows使用mvnw.cmd quarkus:dev

$ ./mvnw quarkus:dev

✓预期输出：控制台显示'Listening on: http://localhost:8080'和'Quarkus application started in X.XXXs'，表示服务器已启动。

💡首次运行可能需要下载依赖，请耐心等待。

✅ 验证应用运行

访问默认的REST端点确认应用正常工作。

✓浏览器打开http://localhost:8080/hello显示'Hello from RESTEasy Reactive'
✓控制台无错误日志，保持运行状态

⚡ 快速提示

开发效率开发模式下修改代码会自动重载，无需重启服务器。

操作使用Ctrl+C停止开发服务器。

🔍 常见问题排查

❓ Maven命令失败，提示'command not found'或类似错误。

→ 检查Maven和Java安装，确保已添加到系统PATH环境变量。

❓ 启动时端口8080被占用。

→ 停止占用端口的进程，或通过-Dquarkus.http.port=新端口参数指定其他端口。

🎯 下一步

探索更多扩展

使用mvn quarkus:list-extensions查看可用扩展，如数据库或消息队列。

构建原生可执行文件

运行./mvnw package -Pnative生成优化后的原生应用（需GraalVM）。