SpringBoot：模块探究之spring-boot-cli

SpringBoot CLI是一个用于构建和运行SpringBoot项目的命令行工具，通过Groovy脚本简化了项目创建和启动过程。它可以用于启动如Eureka、Zipkin、ConfigServer等SpringCloud服务。本文详细介绍了SpringBoot CLI的安装、配置以及使用示例，展示了如何通过简单的Groovy或Java脚本快速启动Web应用。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Spring Boot CLI 是运行 SpringBoot 命令的命令行工具，能够帮助你快速的构建 Spring Boot 项目。只需要编写简单的 groovy 脚本，即可用最少的代码构建并运行一个完整的 Spring Boot 项目。

Spring Boot CLI 为 SpringCloud 提供了 SpringBoot 命令行功能。我们可以编写 groovy 脚本来运行 SpringCloud 组件应用程序（例如 @enableurekaserver）。我们还可以轻松地执行加密和解密等操作，以支持具有机密配置值的 SpringCloud 配置客户端。使用启动器 cli，我们可以从命令行方便地同时启动诸如 eureka、zipkin、config server 等服务（这在开发时非常有用）。

~

本篇内容包括：spring-boot-cli 模块介绍、spring-boot-cli 模块安装、spring-boot-cli 模块 DEMO

文章目录

一、spring-boot-cli 模块介绍

1、关于 spring-boot-cli 模块

Spring Boot CLI 是运行 SpringBoot 命令的命令行工具，能够帮助你快速的构建 Spring Boot 项目。只需要编写简单的 groovy 脚本，即可用最少的代码构建并运行一个完整的 Spring Boot 项目。

Spring Boot CLI 为 SpringCloud 提供了 SpringBoot 命令行功能。我们可以编写 groovy 脚本来运行 SpringCloud 组件应用程序（例如 @enableurekaserver）。我们还可以轻松地执行加密和解密等操作，以支持具有机密配置值的 SpringCloud 配置客户端。使用启动器 cli，我们可以从命令行方便地同时启动诸如 eureka、zipkin、config server 等服务（这在开发时非常有用）。

2、关于 Groovy 语言

Groovy 是一种基于 JVM（Java虚拟机）的敏捷开发语言，它结合了 Python、Ruby 和 Smalltalk 的许多强大的特性，Groovy 代码能够与 Java 代码很好地结合，也能用于扩展现有代码。由于其运行在 JVM 上的特性，Groovy 也可以使用其他非 Java 语言编写的库。

3、spring-boot-cli 源码地址

spring-boot-cli 位于 spring-boot 项目中。

spring-boot-cli 在源码地址为：https://github.com/spring-projects/spring-boot/tree/v2.1.0.RELEASE/spring-boot-project/spring-boot-cli

4、spring-boot-cli 优势

spring-boot-cli 具有以下优势/特点：

Spring boot CLI 应用程序使用 groovy。我们在应用程序中创建 groovy 文件，为此我们不需要提供 groovy 的任何 JAR 依赖。SpringBoot 会自己配置 groovy 的 JAR 依赖项；

二、spring-boot-cli 模块安装

1、spring-boot-cli 模块官网地址

spring-boot-cli 官网地址：https://docs.spring.io/spring-boot/docs/current/reference/html/cli.html#cli.

spring-boot-cli 安装官网地址: https://docs.spring.io/spring-boot/docs/current/reference/html/getting-started.html#getting-started.installing.cli.

spring-boot-cli 版本安装地址: https://repo.spring.io/ui/native/release/org/springframework/boot/spring-boot-cli

PS：此处采用的版本与上图不同为 2.5.5

2、spring-boot-cli 模块安装

# 自行选择压缩包及版本后下载，解压后目录：

3、spring-boot-cli 模块环境变量配置

# vi ~/.bash_profile 添加以下内容

export SPRING_HOME=/Users/lizhengi/Downloads/spring-2.5.5
export PATH=$PATH:$SPRING_HOME/bin

# source ~/.bash_profile 更新环境变量

# 查看版本验证配置成功 spring --version

lizhengi@localhost ~ % spring --version
Spring CLI v3.0.0

三、spring-boot-cli 模块 DEMO

1、新建脚本

一般 Java 想要启动一个 web 应用需要很多样板代码与配置，一个基于 Spring 的 web 应用就更加可怕了，如果没有IDE的帮助，新建一个估计得查半天资料。而使用 Spring Boot CLI 我们只需要一个文件！

# 新建一个 Groovy 脚本：hello.groovy

@RestController
class ThisWillActuallyRun {
    @RequestMapping("/")
    String home() {
        "Hello World!--------"
    }
}

# 或者新建一个 Java 脚本：hello.java

@RestController
public class Hello {
    @RequestMapping("/hello")
    public String hello() {
        return "Hello World Java!";
    }
}

2、运行脚本

然后执行

$ spring run app.groovy

第一次执行会下载依赖，会慢一些，之后就很快了，通过localhost:8080可以访问这个应用。

如果想指定别的端口：

$ spring run hello.groovy -- --server.port=9000