Spring Boot 配置启动字符画（Banner）教程

在 Spring Boot 项目中，我们可以在应用启动时显示一个 ASCII 字符画（Banner），不仅美观，还可以展示项目名称、版本号等信息。本文将讲解如何配置，并给出示例。

---

1️⃣ 使用 Spring Boot 默认 Banner

Spring Boot 默认会在启动时打印一个 Spring Boot Logo，但你可以自定义内容。

步骤

1. 在项目目录下创建 resources 文件夹（如果没有）。
2. 在 src/main/resources/ 下创建文件 banner.txt。
3. 将你希望显示的 ASCII 字符画内容写入 banner.txt。

注意：Spring Boot 会自动读取 banner.txt，不需要额外配置。

---

2️⃣ 从在线工具生成 ASCII 字符画

可以使用 TAAG - Text to ASCII Art Generator 生成字符画。

示例

• 字体选择：Small Block
• 内容：blog-springboot
• 版本号：v3.1.2

生成的字符画示例：

         ▐    ▌  ▜
▛▀▖▌ ▌▚▗▘▜▀▄▄▖▛▀▖▐ ▞▀▖▞▀▌
▌ ▌▌ ▌▗▚ ▐ ▖  ▌ ▌▐ ▌ ▌▚▄▌
▘ ▘▝▀▘▘ ▘ ▀   ▀▀  ▘▝▀ ▗▄▘
                   V3.1.2

将以上内容直接放入 src/main/resources/banner.txt，启动 Spring Boot 项目即可看到效果。

---

3️⃣ 完整示例

项目结构示意：

my-blog/
├─ src/
│  ├─ main/
│  │  ├─ java/
│  │  │  └─ com/example/blog/BlogApplication.java
│  │  └─ resources/
│  │     └─ banner.txt
└─ pom.xml

BlogApplication.java 示例：

package com.example.blog;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class BlogApplication {

    public static void main(String[] args) {
        SpringApplication.run(BlogApplication.class, args);
    }

}

启动时控制台将显示 banner.txt 中的字符画。

---

4️⃣ 可选配置

1. 自定义 Banner 输出方式

可以在 application.properties 中配置 Banner 显示位置：

# 关闭 Banner
spring.main.banner-mode=off

# 或者打印到日志而不是控制台
spring.main.banner-mode=log

2. 使用占位符

Banner 支持 ${} 占位符，例如：

         ▐    ▌  ▜
▛▀▖▌ ▌▚▗▘▜▀▄▄▖▛▀▖▐ ▞▀▖▞▀▌
▌ ▌▌ ▌▗▚ ▐ ▖  ▌ ▌▐ ▌ ▌▚▄▌
▘ ▘▝▀▘▘ ▘ ▀   ▀▀  ▘▝▀ ▗▄▘
                  ${application.version}

然后在 application.properties 中设置版本号：

application.version=3.1.2

---

5️⃣ 总结

• Spring Boot 支持在启动时显示 Banner，非常灵活。
• 可以使用 patorjk.com 在线生成各种字体的 ASCII 字符画。
• Banner 可放置在 src/main/resources/banner.txt，也可通过属性控制输出方式。

---

这样就可以让你的 Spring Boot 项目在启动时显示炫酷的 ASCII 字符画了！