Quarkus 作为专为云原生、容器化设计的Java框架，凭借超快速的启动速度、极低的内存占用和极致的开发体验，成为了Java云原生开发的热门选择。而Quarkus官方为了进一步降低入门门槛，将JBang作为CLI的核心安装工具，让开发者无需提前配置Java环境、无需折腾Maven/Gradle，一行命令就能完成Quarkus环境搭建。

本文将从JBang的核心价值讲起，一步步带你完成Quarkus的安装、项目创建、运行和热部署开发，全程零复杂配置，真正实现“开箱即用”。

先搞懂：JBang是什么？为什么Quarkus选它？

在安装Quarkus之前，必须先了解JBang——这个轻量级工具是Quarkus极简入门的核心，也是解决Java开发“环境配置繁琐”痛点的利器。

JBang 核心定义

JBang 是一款轻量级Java运行和构建工具，它的核心能力是：无需提前安装配置JDK、Maven/Gradle，就能直接运行Java代码、管理Java依赖、安装Java应用程序。JBang会自动下载所需的JDK和依赖，全程无感式处理，让Java开发像Python/Node.js一样简单。

Quarkus 选择JBang的原因

Java开发者的传统痛点是：搭建框架环境前，需要先装对应版本的JDK、配置环境变量、安装构建工具，步骤繁琐且容易出环境兼容问题。

Quarkus将JBang作为CLI的默认安装方式，正是为了彻底消除环境配置门槛：

1. 无需提前安装Java，JBang会自动适配并下载Quarkus所需的JDK版本；
2. 一行命令完成Quarkus CLI的安装和更新，无需手动处理依赖；
3. 跨平台兼容，Linux、macOS、Windows（WSL/Powershell）都能统一使用简洁的命令；
4. 轻量无侵入，安装的Quarkus CLI独立运行，不会污染本地现有Java环境。

简单来说：有了JBang，零基础的Java开发者也能在1分钟内搭好Quarkus开发环境。

第一步：通过JBang安装Quarkus CLI

Quarkus的所有开发操作都基于Quarkus CLI，官方推荐优先通过JBang安装，分两大平台提供了专属命令，复制粘贴即可执行，全程无需手动干预。

平台1：Linux、macOS、Windows（WSL/兼容bash的shell，如Cygwin/MinGW）

打开终端，依次执行以下两条命令，第一条为JBang添加Quarkus仓库信任，第二条安装Quarkus CLI（--fresh --force确保安装最新版本）：

curl -Ls https://sh.jbang.dev | bash -s - trust add https://repo1.maven.org/maven2/io/quarkus/quarkus-cli/
curl -Ls https://sh.jbang.dev | bash -s - app install --fresh --force quarkus@quarkusio

平台2：Windows 原生Powershell

打开Powershell（建议以管理员身份运行），依次执行以下两条命令，逻辑和Linux/macOS一致：

iex "& { $(iwr https://ps.jbang.dev) } trust add https://repo1.maven.org/maven2/io/quarkus/quarkus-cli/"
iex "& { $(iwr https://ps.jbang.dev) } app install --fresh --force quarkus@quarkusio"

关键注意点

如果是首次安装JBang/Quarkus CLI，安装完成后需要重启你的终端/shell，让系统识别Quarkus命令。

备选安装方式：SDKMAN!

如果你的本地已经配置了SDKMAN!（Java多版本管理工具），也可以用更简洁的命令安装Quarkus CLI，作为JBang的补充：

sdk install quarkus

第二步：创建第一个Quarkus项目

Quarkus CLI提供了极简的项目创建命令，一行命令就能生成一个可直接运行的基础Quarkus项目，包含所有核心配置和示例代码，无需手动创建目录和pom.xml。

在终端中执行以下命令：

quarkus create && cd code-with-quarkus

• quarkus create：创建默认的Quarkus项目，项目名默认为code-with-quarkus，基于Maven构建，内置RESTEasy Reactive（Quarkus官方REST框架）；
• cd code-with-quarkus：自动进入项目根目录，方便后续运行项目。

生成的项目结构是Quarkus的标准结构，核心代码在src/main/java，配置文件在src/main/resources/application.properties，无需做任何修改就能直接运行。

第三步：运行Quarkus项目，开启开发模式

Quarkus的核心开发体验之一是开发模式（dev mode），通过quarkus dev命令启动，它不仅能启动项目，还内置了热部署、实时日志、调试等能力，是开发阶段的首选运行方式。

在项目根目录（code-with-quarkus）执行以下命令：

quarkus dev

执行成功后，终端会输出类似以下的日志，说明项目已成功运行：

__  ____  __  _____   ___  __ ____  ______
 --/ __ \/ / / / _ | / _ \/ //_/ / / / __/
 -/ /_/ / /_/ / __ |/ , _/ ,< / /_/ /\ \
--\___\_\____/_/ |_/_/|_/_/|_|\____/___/
2026-XX-XX XX:XX:XX INFO  [io.quarkus] (main) code-with-quarkus 1.0.0-SNAPSHOT on JVM (powered by Quarkus XXX) started in 0.5s. Listening on: http://localhost:8080
2026-XX-XX XX:XX:XX INFO  [io.quarkus] (main) Profile dev activated. Live Coding activated.
2026-XX-XX XX:XX:XX INFO  [io.quarkus] (main) Installed features: [cdi, resteasy-reactive, smallrye-context-propagation, vertx]

此时打开浏览器，访问http://localhost:8080，就能看到Quarkus的默认欢迎页；访问http://localhost:8080/hello，会返回示例接口的响应：Hello RESTEasy。

开发模式的核心优势

1. 超快速启动：Quarkus在开发模式下启动时间以毫秒计，远快于传统Java框架；
2. 资源占用极低：运行时内存占用仅几十MB，适合本地开发；
3. 热部署已开启：修改代码后无需重启项目，刷新浏览器就能看到变化（这也是下一步的核心操作）。

第四步：体验Quarkus的热部署（Live Coding）

Quarkus的**热部署（Live Coding）**是开发效率的“杀手锏”，而开发模式下会自动开启该功能，无需任何额外配置。我们只需修改示例的REST接口代码，就能实时看到效果。

步骤1：打开核心示例代码

找到项目中的src/main/java/org/acme/GreetingResource.java文件，这是Quarkus自动生成的REST接口示例，原始代码如下：

package org.acme;

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

@Path("/hello") // 接口访问路径：/hello
public class GreetingResource {

    @GET // 请求方式：GET
    @Produces(MediaType.TEXT_PLAIN) // 响应类型：纯文本
    public String hello() {
        return "Hello RESTEasy"; // 接口返回值
    }
}

步骤2：修改代码并保存

将代码中的返回值从Hello RESTEasy修改为任意内容，比如Hola from RESTEasy Reactive（西班牙语的“你好”），修改后保存文件：

public String hello() {
    return "Hola from RESTEasy Reactive";
}

步骤3：刷新浏览器看效果

无需重启quarkus dev进程，直接刷新浏览器的http://localhost:8080/hello地址，就能看到修改后的响应内容，整个过程耗时不到1秒。

这就是Quarkus热部署的魅力：开发过程中无需关注项目重启，专注于代码编写即可，彻底告别传统Java框架“修改一行代码，重启五分钟”的痛点。

核心总结：Quarkus极简入门的核心亮点

通过JBang搭建Quarkus环境并完成第一个项目，我们能清晰感受到Quarkus为Java开发带来的革命性体验，核心亮点可总结为三点：

1. 环境零配置：依托JBang，无需提前装JDK、配环境变量，一行命令完成CLI安装，Java新手也能快速上手；
2. 开发极致高效：quarkus create一键生成项目，quarkus dev开启开发模式，热部署实时生效，大幅提升开发效率；
3. 云原生天生适配：项目从创建开始就遵循云原生设计规范，运行时轻量、启动快，直接适配容器、K8s等云原生环境，无需后续改造。

Quarkus凭借“为云而生”的设计和“开发者友好”的体验，让Java在云原生时代重新焕发生机，而JBang则让这份体验的入门门槛降到了最低——现在，你已经完成了Quarkus的第一步，接下来就是解锁更多云原生开发的玩法了！