為什么我們需要“彩色日志輸出”？

在日常開發中，控制臺輸出是我們定位問題、追蹤流程的第一前線。如果你仍然在盯著單一顏色的黑白日志輸出，試想下：在密密麻麻的 DEBUG/INFO/WARN/ERROR 中快速定位錯誤點，是不是眼睛很容易疲勞，注意力也容易渙散？

本篇文章將圍繞一個目標展開：如何為你的 Spring Boot 項目添加彩色日志輸出，無論你使用的是原生日志輸出、Logback、Log4j2，還是 IDEA 本地控制臺，都能輕松適配。通過色彩增強視覺分層，讓日志一眼可讀、調試更高效！

項目目錄結構

以下是本文所提到的文件路徑：

project-root/
├── src/
│   └── main/
│       └── resources/
│           ├── application.yml
│           ├── logback.xml         # 如使用 Logback
│           └── log4j2.xml          # 如使用 Log4j2

IDEA 控制臺彩色日志插件（適合開發調試）

如果你在用 IntelliJ IDEA 進行開發，推薦使用 Grep Console 插件，它可以對日志輸出進行顏色高亮，適合本地開發環境提升調試效率。

安裝插件

依次點擊：

File → Settings → Plugins → Marketplace → 搜索 “Grep Console” → Install

安裝完成后，進入：

Settings → Other Settings → Grep Console

設置日志顏色規則

在匹配規則中設置關鍵詞（如 ERROR, WARN, INFO），并分別設置對應字體顏色，例如：

• ERROR：紅色
• WARN：黃色
• INFO：綠色
• DEBUG：青色

效果展示：日志瞬間煥然一新，重要信息高亮突出，層級一目了然！

Spring Boot 原生彩色日志（推薦方式）

Spring Boot 自帶了 ANSI 彩色日志輸出支持，適合 開發環境使用，生產環境建議關閉。

application.yml 配置如下：

spring:
  output:
    ansi:
      enabled: always


logging:
  pattern:
    console: "%clr(%d{yyyy-MM-dd HH:mm:ss.SSS}){faint} %clr(%5p) %clr(%-40.40logger{39}){cyan} : %msg%n"

效果解讀：

• 時間戳（淡色）：輔助參考
• 日志級別（自動上色）：ERROR → 紅色，WARN → 黃色，INFO → 綠色，DEBUG → 青色
• 類名（青色）：方便定位源頭
• 消息內容：保持原樣，清晰可讀

通過 VM 參數啟用彩色輸出

Spring Boot 項目中配置 VM 參數

進入 IDEA → Run → Edit Configurations → 添加 VM 參數：

-Dspring.output.ansi.enabled=ALWAYS

適用于臨時啟用，便于調試驗證色彩方案。

如果使用 Log4j2：

也可以通過 VM 參數強制啟用 ANSI 支持，前提是你的終端環境支持 ANSI 色彩。

Logback 配置彩色日志（通用型方案）

如果你項目使用了 Logback 作為日志實現，可以通過配置 logback.xml 實現彩色輸出。

在 src/main/resources/logback.xml 添加如下配置：

<configuration scan="true" scanPeriod="60 seconds" debug="false">
    <appender name="log_pattern" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss} %highlight(%-5level) %cyan(%logger{20}) - %msg%n</pattern>
        </encoder>
    </appender>


    <root level="debug">
        <appender-ref ref="log_pattern" />
    </root>
</configuration>

效果演示

• ERROR → 紅色
• WARN → 黃色
• INFO → 綠色
• DEBUG → 青色 更重要的是，%highlight 會根據日志級別自動上色。

Log4j2 配置彩色日志（更靈活的控制）

Log4j2 的 PatternLayout 也原生支持 ANSI 高亮。

在 src/main/resources/log4j2.xml 添加配置：

<Configuration>
    <Appenders>
        <Console name="Console" target="SYSTEM_OUT">
            <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} | %highlight{%p} | %t | %highlight{%c{2}} |- %m%n"/>
        </Console>
    </Appenders>


    <Loggers>
        <Root level="debug">
            <AppenderRef ref="Console"/>
        </Root>
    </Loggers>
</Configuration>

結語：別再用黑白控制臺調試你的應用了！

開發效率是從細節中提升的，彩色日志就是其中一個被嚴重低估的利器。不僅視覺上更舒適、層次分明，還能加快日志閱讀效率、提升問題定位速度，是真正能“提神醒腦”的開發利器。

無論你使用 Spring Boot 默認日志、Logback、Log4j2，還是 IDEA 插件，都有對應的彩色輸出實現方案，本文已為你一一羅列，復制即用！

 建議：開發環境啟用彩色日志，生產環境依舊使用純文本，避免干擾日志收集系統。