Java输出带颜色的字，怎么实现？终端/控制台颜色输出方法？

在Java开发中,为控制台输出添加颜色能够有效提升信息展示的层次感和可读性，例如通过颜色区分不同级别的日志、突出重要数据或增强用户交互体验，本文将详细介绍Java输出带颜色的字的多种实现方式，涵盖ANSI转义码、第三方库以及跨平台解决方案，帮助开发者根据实际需求选择合适的技术路径。

ANSI转义码：跨平台的原生方案

ANSI转义码是一套控制终端显示的标准指令,大多数现代终端（如Linux/macOS的Terminal、Windows 10+的Windows Terminal）均支持通过它控制文本颜色、样式等，Java中可直接通过字符串拼接转义码实现彩色输出，无需额外依赖。

基本语法

ANSI转义码格式为\033[<代码>m，其中\033是ESC字符的八进制表示，<代码>由数字或分号分隔的数字序列组成，分别表示样式和颜色。

• 文本颜色：30（黑）、31（红）、32（绿）、33（黄）、34（蓝）、35（紫）、36（青）、37（白）
• 背景颜色：40-47，对应文本颜色的8种背景色
• 样式：0（重置）、1（加粗）、4（下划线）

实现示例

public class AnsiColorDemo {
    public static void main(String[] args) {
        // 红色文本
        System.out.println("\033[31m这是红色文字\033[0m");
        // 绿色背景加粗
        System.out.println("\033[1;42m绿色背景加粗文字\033[0m");
        // 多色组合
        System.out.println("\033[35;1;4m紫色加粗下划线\033[0m");
    }
}

注意事项

• Windows兼容性：早期Windows的cmd.exe不支持ANSI转义码，需通过System.setProperty("file.encoding", "UTF-8")或使用Jansi库（后文详述）启用支持，Windows 10及以上版本默认支持，需开启“使用旧版控制台”选项。
• 重置样式：每次颜色输出后需添加\033[0m重置，否则后续文本可能延续当前样式。

第三方库：简化开发的利器

手动拼接ANSI转义码可读性较差,且需记忆大量代码，第三方库提供了更优雅的API，封装了底层细节，支持更丰富的功能（如颜色命名、样式链式调用）。

Jansi库

Jansi是专门为Java设计的ANSI支持库,兼容Windows、Linux、macOS等平台，无需手动处理终端兼容性问题。

依赖引入（Maven）：

<dependency>
    <groupId>org.fusesource.jansi</groupId>
    <artifactId>jansi</artifactId>
    <version>2.4.0</version>
</dependency>

使用示例：

import org.fusesource.jansi.Ansi;
import org.fusesource.jansi.AnsiConsole;
public class JansiDemo {
    public static void main(String[] args) {
        AnsiConsole.systemInstall(); // 初始化Jansi
        System.out.println(Ansi.ansi().fg(Ansi.Color.RED).a("红色文字").reset());
        System.out.println(Ansi.ansi().fg(Ansi.Color.BLUE).a(Ansi.Attribute.BOLD).a("蓝色加粗").reset());
    }
}

Apache Commons CLI

虽然Commons CLI主要用于命令行解析，但其HelpFormatter类支持彩色输出，适合构建工具类时快速集成。

依赖引入（Maven）：

<dependency>
    <groupId>commons-cli</groupId>
    <artifactId>commons-cli</artifactId>
    <version>1.4</version>
</dependency>

其他轻量级库

• Colored Console：支持链式调用，API简洁，适合小型项目。
• JavaFX的Console：若项目基于JavaFX，可通过Console组件实现图形化终端的彩色输出。

跨平台兼容性解决方案

不同操作系统对ANSI的支持存在差异,需通过策略确保颜色效果一致。

检测终端类型

运行时动态检测当前环境,选择是否启用ANSI：

public boolean isAnsiSupported() {
    String os = System.getProperty("os.name").toLowerCase();
    return !os.contains("win") || 
           (os.contains("10") && Boolean.getBoolean("jdk.terminal.ansi"));
}

使用Jansi的自动适配

Jansi通过AnsiConsole.systemInstall()自动检测终端并启用ANSI支持，无需手动处理平台差异。

日志框架集成

在Logback、Log4j2等日志框架中，可通过ANSILayout或JansiAppender实现彩色日志输出，例如Log4j2配置：

<Appender name="Console" class="org.apache.logging.log4j.core.appender.ConsoleAppender">
    <PatternLayout pattern="%style{%d}{red} %highlight{%level}{FATAL=red, ERROR=red, WARN=yellow, INFO=green, DEBUG=cyan} %msg%n"/>
</Appender>

进阶应用与最佳实践

封装工具类

为避免重复代码,可封装ColorPrinter工具类：

public class ColorPrinter {
    public static void printRed(String text) {
        System.out.println("\033[31m" + text + "\033[0m");
    }
    public static void printGreen(String text) {
        System.out.println("\033[32m" + text + "\033[0m");
    }
    // 其他颜色方法...
}

动态颜色配置

通过配置文件或命令行参数动态控制颜色开关,

boolean colorEnabled = Boolean.getBoolean("color.enable");
if (colorEnabled) {
    System.out.println("\033[32m启用颜色\033[0m");
} else {
    System.out.println("禁用颜色");
}

性能优化

频繁的ANSI转义码拼接可能影响性能,可通过预编译常用颜色组合或使用StringBuilder优化。

Java输出带颜色的字主要通过ANSI转义码和第三方库实现,ANSI转义码无需依赖，适合轻量级需求；Jansi等库则提供了更友好的API和跨平台兼容性，开发者可根据项目复杂度、目标平台和团队习惯选择方案，同时注意重置样式、终端兼容性等细节，以实现高效且美观的控制台输出。