为什么控制台对齐的字符表格输出到JTextPane时列无法对齐？

问题根源 #

• 核心原因是JTextPane默认使用变宽字体：控制台默认使用等宽字体（每个字符宽度一致），所以用空格填充的对齐逻辑可以正常生效。但JTextPane默认使用的是宋体、SansSerif这类变宽字体，不同字符占用宽度不同，空格的宽度远小于普通字符，会导致原有填充逻辑完全失效。
• 次要原因是插入文本时未指定统一的等宽样式：你调用insertString时传入的null属性会使用文档的默认样式，若默认样式未设置为等宽，自然无法对齐。

解决方案 #

步骤1：给JTextPane和关联的StyledDocument全局设置等宽字体 #

在初始化JTextPane时执行以下代码，将全局默认样式设置为等宽字体：

JTextPane tableTextPane = new JTextPane();
StyledDocument doc = tableTextPane.getStyledDocument();
// 获取默认样式，设置等宽字体属性
Style defaultStyle = doc.getStyle(StyleContext.DEFAULT_STYLE);
// 优先匹配系统自带的高清等宽字体， fallback到通用等宽字体配置
String[] monoFonts = new String[]{"Consolas", "Monaco", "Courier New", Font.MONOSPACED};
Font monoFont = null;
for (String fontName : monoFonts) {
    monoFont = new Font(fontName, Font.PLAIN, 14);
    if (monoFont.getFamily().equals(fontName)) {
        break;
    }
}
StyleConstants.setFontFamily(defaultStyle, monoFont.getFamily());
StyleConstants.setFontSize(defaultStyle, 14);
// 同步设置组件默认字体，避免手动输入时样式不一致
tableTextPane.setFont(monoFont);

步骤2：可选：优化自定义打印方法逻辑（非对齐问题必要修复，仅优化换行） #

你现有printText方法会在所有传入内容前加换行，可能导致表格首行前多空行，可调整为仅当文档不为空时加换行：

//to replace println
public void printText(String toPrint){
    try {
        // 仅当文档已有内容时前置换行，避免首行空行
        if (doc.getLength() > 0) {
            toPrint = "\n" +  toPrint;
        }
        doc.insertString(doc.getLength(), toPrint, null);
    } catch (BadLocationException ex) {
        ex.printStackTrace();
    }
}

验证方法 #

将你生成的表格字符串复制到支持等宽字体的编辑器（如记事本、代码编辑器）中切换到等宽字体查看，若对齐正常则说明修复字体后JTextPane即可正常显示。

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