Java 中使用二维数组格式化输出表格的完整教程

本文讲解如何用 java 二维数组构建结构化表格（如国家与首都对照表），重点解决列对齐问题，通过动态计算最大字段宽度、自定义空格填充和方法拆分实现清晰、可维护的格式化输出。

在 Java 中，初学者常误以为“表格”需依赖 GUI 组件（如 JTable）或外部库，但实际上，仅用基础二维数组配合字符串格式化即可在控制台模拟整齐的文本表格。关键挑战在于列对齐——若直接逐行打印，因各国名称长度不一（如 "Mexico" vs "Guatemala"），会导致第二列（首都）错位。

核心思路是：先确定第一列的最大宽度，再为每行的国家名补足空格，使所有首都列起始位置统一。以下是一个专业、可扩展的实现方案：

✅ 推荐写法：职责分离 + 动态对齐

public class Arrays39 {
    public static void main(String[] args) {
        String[][] countries = {
            {"Mexico", "DF"},
            {"Guatemala", "Guatemala City"},
            {"El Salvador", "El Salvador"},
            {"Russia", "Moscow"}
        };
        generateTable(countries, maxPadding(countries));
    }

    // 主输出方法：打印表头 + 每行数据
    public static void generateTable(String[][] data, int padding) {
        // 表头："Country" 后接足够空格，再拼接 "Capital"
        System.out.printf("Country%sCapital%n", addPadding("", padding - "Country".length()));
        for (String[] row : data) {
            // 每行：国家名 + 动态空格 + 首都名
            System.out.printf("%s%s%s%n", row[0], addPadding(row[0], padding), row[1]);
        }
    }

    // 计算第一列（国家名）的最大字符长度
    private static int maxPadding(String[][] data) {
        int max = "Country".length(); // 表头也参与对齐基准
        for (String[] row : data) {
            max = Math.max(max, row[0].length());
        }
        return max;
    }

    // 生成指定长度的空格字符串：padding - currentLength
    private static String addPadding(String str, int targetWidth) {
        int spaces = targetWidth - str.length();
        return spaces > 0 ? " ".repeat(spaces) : "";
    }
}

? 说明： 使用 String.repeat(int)（Java 11+）替代 StringBuilder 循环拼接，更简洁安全；若用旧版 JDK，可回退为 new String(new char[spaces]).replace('\0', ' ')。 表头 "Country" 被纳入 maxPadding() 计算，确保标题与数据自然对齐。 printf 的 %n 是平台无关换行符，比 \n 更健壮。

⚠️ 注意事项与优化建议

• 避免硬编码列数：当前示例固定为 [i][0] 和 [i][1]，实际项目中可用常量（如 COUNTRY_IDX = 0, CAPITAL_IDX = 1）提升可读性。
• 空值防护：生产代码应检查 row != null && row.length >= 2，防止 NullPointerException 或 ArrayIndexOutOfBoundsException。
• 扩展性思考：若需支持多列或动态列宽（如第三列为“人口”），可将 addPadding 改为接受列索引，并基于每列独立计算最大宽度。
• 替代方案：对于复杂格式需求，推荐使用 Apache Commons Lang 的 StringUtils.rightPad()，或引入 TextTable 等轻量库。

掌握这种“计算—填充—格式化”三步法，不仅能解决表格对齐问题，更是理解 Java 字符串处理与面向对象设计原则（单一职责、方法复用）的重要实践。