
在linux或macos等操作系统中,终端通常默认支持ansi转义序列,因此java程序可以直接使用\u001b[33m这样的代码来输出彩色文本。然而,windows的cmd终端在较旧的版本中并不原生支持ansi。即使是windows 10版本1511及更高版本,虽然引入了对ansi转义序列的支持,但出于兼容性考虑,默认情况下并未完全启用。
对于Java应用程序而言,java.exe本身并未被标记为使用ANSI,也未显式调用Windows API来启用ANSI支持。这导致在标准的Windows CMD中直接运行包含ANSI颜色代码的Java程序时,这些转义序列会被原样输出,而不是被解释为颜色指令。而像VS Code这样的集成开发环境,其内置终端通常会模拟一个支持ANSI的终端环境(例如通过PowerShell或Git Bash),因此在其中运行Java代码时,颜色能够正常显示。
一种通用的解决方案是利用Windows系统自带的命令(如echo)来处理ANSI颜色代码的输出。echo命令在某些情况下能够正确解析并显示ANSI序列,因为它本身是操作系统的一部分,可以访问底层的终端功能。
我们可以通过Java的ProcessBuilder来执行外部命令,并将带有ANSI代码的字符串作为参数传递给echo。
示例代码:
立即学习“Java免费学习笔记(深入)”;
import java.io.IOException;
public class ConsoleOutput {
// 定义ANSI颜色代码
public static final String ANSI_RESET_ALL = "\u001B[0m"; // 重置所有属性
public static final String ANSI_YELLOW_FG = "\u001B[33m"; // 黄色前景
public static final String ANSI_RESET_FG = "\u001B[39m"; // 重置前景色
public static void main(String[] args) {
// 打印彩色文本
println(ANSI_YELLOW_FG + "This text is yellow" + ANSI_RESET_FG);
// 打印普通文本
println("This is normal color");
}
/**
* 通过外部cmd命令打印字符串
* @param s 要打印的字符串,可包含ANSI颜色代码
*/
static void println(String s) {
try {
// 构建并执行cmd命令:cmd /c echo [字符串]
// /c 参数表示执行完命令后关闭cmd
// inheritIO() 使子进程的输入、输出和错误流与当前Java进程共享
new ProcessBuilder("cmd", "/c", "echo " + s)
.inheritIO()
.start()
.waitFor(); // 等待子进程完成
} catch (InterruptedException | IOException e) {
// 捕获中断或IO异常
throw new RuntimeException("Failed to execute external command for printing.", e);
}
}
}注意事项:
从Java 22开始,引入了Foreign Function & Memory API (FFM API) (JEP 454),允许Java程序更方便、安全地与原生代码进行交互,而无需JNI等复杂的原生辅助代码。通过FFM API,我们可以直接调用Windows的kernel32.dll中的函数来启用控制台的虚拟终端处理模式,从而使CMD终端原生支持ANSI颜色代码。
示例代码:
立即学习“Java免费学习笔记(深入)”;
import java.lang.foreign.*; // 导入FFM API相关类
import java.lang.invoke.MethodHandle;
public class ConsoleOutput {
// 定义ANSI颜色代码
public static final String ANSI_RESET_ALL = "\u001B[0m";
public static final String ANSI_YELLOW_FG = "\u001B[33m";
public static final String ANSI_RESET_FG = "\u001B[39m";
// Windows API常量
static final int STD_OUTPUT_HANDLE = -11; // 标准输出句柄
static final int ENABLE_PROCESSED_OUTPUT = 0x0001; // 启用处理输出
static final int ENABLE_VIRTUAL_TERMINAL_PROCESSING = 0x0004; // 启用虚拟终端处理
public static void main(String[] args) {
// 尝试初始化ANSI支持
if (initANSI()) {
System.out.println("ANSI support should now be enabled.");
} else {
System.out.println("Failed to enable ANSI support or already enabled.");
}
// 打印彩色文本,此时CMD应能正确显示颜色
System.out.println(ANSI_YELLOW_FG + "This text is yellow" + ANSI_RESET_FG);
System.out.println("This is normal color");
}
/**
* 调用Windows API启用控制台的虚拟终端处理模式
* @return 如果成功启用,则返回true
*/
static boolean initANSI() {
try (Arena arena = Arena.ofConfined()) { // 创建一个受限的内存区域
// 查找kernel32.dll库
SymbolLookup sl = SymbolLookup.libraryLookup("kernel32.dll", arena);
Linker linker = Linker.nativeLinker(); // 获取原生链接器
// 查找并获取GetStdHandle函数的MethodHandle
MethodHandle GetStdHandle = linker.downcallHandle(
sl.find("GetStdHandle").orElseThrow(() -> new RuntimeException("GetStdHandle not found")),
FunctionDescriptor.of(ValueLayout.ADDRESS, ValueLayout.JAVA_INT) // 函数签名:返回地址,参数为int
);
// 查找并获取SetConsoleMode函数的MethodHandle
MethodHandle SetConsoleMode = linker.downcallHandle(
sl.find("SetConsoleMode").orElseThrow(() -> new RuntimeException("SetConsoleMode not found")),
FunctionDescriptor.of(ValueLayout.JAVA_BOOLEAN, ValueLayout.ADDRESS, ValueLayout.JAVA_INT) // 函数签名:返回boolean,参数为地址和int
);
// 调用GetStdHandle获取标准输出句柄
MemorySegment hConsole = (MemorySegment) GetStdHandle.invokeExact(STD_OUTPUT_HANDLE);
// 调用SetConsoleMode启用虚拟终端处理模式
// 参数为句柄和模式标志(ENABLE_PROCESSED_OUTPUT | ENABLE_VIRTUAL_TERMINAL_PROCESSING)
return (boolean) SetConsoleMode.invokeExact(hConsole,
ENABLE_PROCESSED_OUTPUT | ENABLE_VIRTUAL_TERMINAL_PROCESSING);
} catch (RuntimeException | Error unchecked) {
throw unchecked;
} catch (Throwable e) {
throw new AssertionError("Error during ANSI initialization: " + e.getMessage(), e);
}
}
}注意事项:
在Java应用程序中实现Windows CMD终端的彩色输出,需要克服CMD对ANSI转义序列的默认限制。对于Java 22之前的版本或追求通用兼容性的场景,通过ProcessBuilder委托给外部echo命令是一种可行的方案,但需注意其性能开销。而对于Java 22及更高版本,利用FFM API直接调用Windows原生函数来启用虚拟终端处理,则提供了一种更高效、更原生的解决方案。在实际开发中,应根据项目需求、Java版本和目标操作系统环境选择最合适的实现方式,或考虑使用成熟的第三方库来简化跨平台终端输出的管理。
以上就是解决Java在Windows CMD终端中ANSI颜色代码显示异常的问题的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号