服务端开发

Appearance

Spring Boot CLI：快速启动项目的命令行利器 🚀 ​

什么是 Spring Boot CLI？ ​

Spring Boot CLI（Command Line Interface）是 Spring Boot 生态系统中的一个强大的命令行工具。它就像是一个"项目魔法师"，能够帮助开发者快速创建新项目、管理依赖，甚至处理一些常见的开发任务。

NOTE

CLI 工具的核心价值在于提高开发效率，让开发者能够通过简单的命令行操作完成复杂的项目初始化工作。

为什么需要 Spring Boot CLI？🤔 ​

传统项目创建的痛点 ​

在没有 CLI 工具之前，创建一个新的 Spring Boot 项目通常需要：

text
1. 打开浏览器访问 start.spring.io
2. 手动选择项目配置（语言、版本、依赖等）
3. 下载生成的项目压缩包
4. 解压到本地目录
5. 导入到 IDE 中
6. 等待依赖下载完成
text
1. 一条命令搞定：spring init my-project
2. 直接开始编码

CLI 解决的核心问题 ​

  1. 提升开发效率：减少重复性的项目创建工作
  2. 标准化项目结构：确保项目遵循 Spring Boot 最佳实践
  3. 简化依赖管理：通过命令快速添加常用依赖
  4. 自动化工具集成：提供密码编码等实用功能

Spring Boot CLI 的核心功能 ​

1. 项目初始化功能 ⭐ ​

CLI 最重要的功能就是快速创建新项目：

bash
# 创建一个基础的 Spring Boot 项目
spring init my-awesome-project

# 创建带有特定依赖的项目
spring init --dependencies=web,jpa,mysql my-web-app

# 指定项目元数据
spring init --name=MyApp --package-name=com.example.myapp my-app

2. 密码编码功能 🔐 ​

在实际开发中，我们经常需要对密码进行编码，CLI 提供了便捷的密码编码功能：

bash
# 使用 BCrypt 编码密码
spring encodepassword mySecretPassword

# 输出示例：{bcrypt}$2a$10$X5wFBtLrL/kHcmrOWwIvQeA7Z2rWxwDvQy7d1J2Lxvg5WDXJW5jO6

实际应用场景示例 ​

场景一：快速创建 Web API 项目 ​

假设我们需要创建一个用户管理的 REST API 项目：

bash
# 创建项目，包含 Web、JPA、MySQL 依赖
spring init \
  --dependencies=web,data-jpa,mysql \
  --name=UserManagementAPI \
  --package-name=com.example.usermgmt \
  user-management-api

创建完成后的项目结构：

user-management-api/
├── src/
│   └── main/
│       ├── kotlin/
│       │   └── com/example/usermgmt/
│       │       └── UserManagementApiApplication.kt
│       └── resources/
│           └── application.properties
├── build.gradle.kts
└── README.md

场景二：安全配置中的密码编码 ​

在 Spring Security 配置中，我们经常需要预设一些用户密码：

kotlin
@Service
class CustomUserDetailsService : UserDetailsService {
    
    // 使用 CLI 生成的编码密码
    private val users = mapOf(
        "admin" to "{bcrypt}$2a$10$X5wFBtLrL/kHcmrOWwIvQeA7Z2rWxwDvQy7d1J2Lxvg5WDXJW5jO6", 
        "user" to "{bcrypt}$2a$10$Y6gGCsUmM/lIdNsSOxJwVuB8A3sXyxEwRz8e2K3Myvh6XEYKX6kP7"
    )
    
    override fun loadUserByUsername(username: String): UserDetails {
        val password = users[username] 
            ?: throw UsernameNotFoundException("用户不存在: $username")
        
        return User.builder()
            .username(username)
            .password(password) // 直接使用编码后的密码
            .authorities("ROLE_USER")
            .build()
    }
}
bash
# 为管理员生成密码
spring encodepassword admin123

# 为普通用户生成密码  
spring encodepassword user456

CLI 工作流程图 ​

安装 Spring Boot CLI ​

方式一：使用 SDKMAN!（推荐） ​

bash
# 安装 SDKMAN!
curl -s "https://get.sdkman.io" | bash

# 安装 Spring Boot CLI
sdk install springboot

方式二：使用 Homebrew（macOS） ​

bash
brew tap spring-io/tap
brew install spring-boot

方式三：手动安装 ​

手动安装步骤
  1. 从 Spring Boot 官网 下载 CLI 压缩包
  2. 解压到指定目录
  3. 将 bin 目录添加到系统 PATH 环境变量中
  4. 验证安装：spring --version

常用命令速查表 ​

命令功能示例
spring init创建新项目spring init my-project
spring init --list查看可用依赖spring init --list
spring encodepassword编码密码spring encodepassword secret
spring --version查看版本spring --version
spring help查看帮助spring help init

高级使用技巧 ​

1. 自定义项目模板 ​

bash
# 创建带有完整 Web 开发栈的项目
spring init \
  --dependencies=web,data-jpa,security,validation,actuator \
  --java-version=17 \
  --packaging=jar \
  --type=gradle-project \
  full-stack-app

2. 批量创建微服务项目 ​

bash
# 创建用户服务
spring init --dependencies=web,data-jpa --name=UserService user-service

# 创建订单服务  
spring init --dependencies=web,data-jpa --name=OrderService order-service

# 创建网关服务
spring init --dependencies=gateway,eureka-client --name=ApiGateway api-gateway

最佳实践建议 ​

提升效率的小技巧

  1. 创建别名：为常用的 spring init 命令创建 shell 别名
  2. 模板化：为团队常用的项目配置创建标准化的初始化脚本
  3. 版本管理：定期更新 CLI 版本以获取最新功能

注意事项

  • 确保网络连接正常，CLI 需要访问 start.spring.io
  • 在企业环境中，可能需要配置代理设置
  • 生成的密码编码结果每次都不同，这是正常的安全特性

总结 ​

Spring Boot CLI 是一个简单而强大的工具，它将复杂的项目创建过程简化为几个命令。通过掌握 CLI 的使用，开发者可以：

✅ 快速启动项目：几秒钟内创建标准化的 Spring Boot 项目
✅ 提高开发效率：减少重复性的配置工作
✅ 保持一致性：确保团队项目结构的标准化
✅ 简化安全配置：轻松生成安全的密码编码

掌握 Spring Boot CLI，让项目创建变得如此简单！ 🎉