Java控制台文本着色失效求助（Windows多语言环境适配）

问题原因 #

1. Windows CMD默认未启用虚拟终端处理：ANSI颜色控制码（如\u001B[31m）需要CMD开启虚拟终端支持才能识别，而IntelliJ、VS Code等IDE的控制台本身内置了ANSI解析逻辑，所以不受系统限制。
2. 日语区域下CMD默认代码页为932（Shift-JIS）：ANSI控制码中的[字符在Shift-JIS编码下会被错误解析为·，导致控制码失效并直接输出乱码字符。

适配不同Windows区域的解决方法 #

1. 启用CMD虚拟终端支持 #

这是让CMD识别ANSI控制码的核心步骤，可通过代码自动实现：

方式一：调用Windows API（推荐，需JNA依赖）

import com.sun.jna.platform.win32.Kernel32;
import com.sun.jna.platform.win32.WinNT;

public class VTEnabler {
    private static final int ENABLE_VIRTUAL_TERMINAL_PROCESSING = 0x0004;

    public static void enableVirtualTerminal() {
        WinNT.HANDLE outputHandle = Kernel32.INSTANCE.GetStdHandle(Kernel32.STD_OUTPUT_HANDLE);
        int[] consoleMode = new int[1];
        
        if (Kernel32.INSTANCE.GetConsoleMode(outputHandle, consoleMode)) {
            consoleMode[0] |= ENABLE_VIRTUAL_TERMINAL_PROCESSING;
            Kernel32.INSTANCE.SetConsoleMode(outputHandle, consoleMode[0]);
        }
    }

    public static void main(String[] args) {
        enableVirtualTerminal();
        // 测试红色文本输出
        System.out.println("\u001B[31m红色消息\u001B[0m");
    }
}

需引入JNA依赖（Maven）：

<dependency>
    <groupId>net.java.dev.jna</groupId>
    <artifactId>jna-platform</artifactId>
    <version>5.13.0</version>
</dependency>

方式二：执行CMD命令开启（无需额外依赖）

import java.io.IOException;

public class ConsoleSetup {
    public static void setupConsole() throws IOException, InterruptedException {
        // 设置代码页为UTF-8并初始化控制台
        new ProcessBuilder("cmd.exe", "/c", "chcp 65001 >nul && mode con")
                .inheritIO()
                .start()
                .waitFor();
    }

    public static void main(String[] args) throws Exception {
        setupConsole();
        System.out.println("\u001B[32m绿色消息\u001B[0m");
    }
}

2. 强制设置CMD代码页为UTF-8（65001） #

无论系统区域是日语还是其他，将代码页切换为UTF-8可确保ANSI控制码的字符正确解析：

• 手动操作：打开CMD后执行chcp 65001
• 代码自动设置：上述代码中已包含chcp 65001命令，可自动完成切换

3. 兼容旧版Windows的第三方库方案 #

如果需要支持Win10 1511版本之前的系统，推荐使用jansi库，它会自动适配不同系统的控制台颜色输出：

import org.fusesource.jansi.Ansi;
import static org.fusesource.jansi.Ansi.ansi;

public class JansiColorDemo {
    public static void main(String[] args) {
        System.out.println(ansi().fg(Ansi.Color.RED).a("红色文本").reset());
        System.out.println(ansi().fg(Ansi.Color.BLUE).a("蓝色文本").reset());
    }
}

引入Maven依赖：

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

4. 验证区域影响的解决效果 #

日语区域下，CMD默认代码页为932，执行chcp 65001切换后，ANSI控制码中的[字符会被正确识别，不再显示为·，颜色输出即可正常工作。

内容的提问来源于stack exchange，提问作者Fledgling Pidgeon